Installation Guide
Complete instructions for installing Tea on Linux, macOS, and Windows.
System Requirements
Required
- Git 2.0+
- C++ compiler (GCC 9+ or Clang 10+)
- LLVM 14+ (for native compilation)
- Make or CMake
- 2GB RAM minimum
Optional
- Python 3.8+ (for build scripts)
Linux
Ubuntu / Debian
Install dependencies:
sudo apt update
sudo apt install git build-essential cmake llvm-14 llvm-14-devClone and build Tea:
git clone https://github.com/special-tea/tea.git
cd tea
make setup
sudo make installFedora / RHEL
Install dependencies:
sudo dnf install git gcc-c++ cmake llvm-develClone and build Tea:
git clone https://github.com/special-tea/tea.git
cd tea
make setup
sudo make installArch Linux
Install dependencies:
sudo pacman -S git base-devel cmake llvmClone and build Tea:
git clone https://github.com/special-tea/tea.git
cd tea
make setup
sudo make installmacOS
Install Xcode Command Line Tools:
xcode-select --installInstall Homebrew (if not already installed):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Install LLVM:
brew install llvmClone and build Tea:
git clone https://github.com/special-tea/tea.git
cd tea
make setup
sudo make installWindows
Windows support is currently experimental. We recommend using WSL2 (Windows Subsystem for Linux) for the best experience.
Option 1: WSL2 (Recommended)
Install WSL2:
wsl --installAfter WSL2 is installed, follow the Linux installation instructions above.
Option 2: Native Windows
Install Visual Studio 2022 with C++ tools
Install Git for Windows
Clone and build:
git clone https://github.com/special-tea/tea.git
cd tea
cmake -B build
cmake --build build --config Release
cmake --install buildVerify Installation
After installation, verify that Tea is working correctly:
Check version:
tea --versionView help:
tea --helpRun a simple test:
echo 'print("Tea is working!")' | tea run -Troubleshooting
Common Issues
Command not found: tea
Make sure /usr/local/bin is in your PATH:
export PATH="/usr/local/bin:$PATH"LLVM not found
LLVM 14+ is required for Tea. Make sure it's properly installed and available in your PATH.
Permission denied during installation
Use sudo for the install step, or install to a user directory:
make install PREFIX=$HOME/.localNext Steps
Now that Tea is installed, you're ready to start coding!