Installation methods
The Timbal CLI provides a command-line interface for managing Timbal projects, including initialization, building, deploying, and other project management tasks.
Use curl to download and execute the installation script:curl -LsSf https://timbal.ai/install.sh | sh
curl, you can use wget:wget -qO- https://timbal.ai/install.sh | sh
Use PowerShell to download and execute the installation script:powershell -ExecutionPolicy ByPass -c "irm https://timbal.ai/install.ps1 | iex"
The installation script may be inspected before use:curl -LsSf https://timbal.ai/install.sh | less
irm https://timbal.ai/install.ps1 | less
Upgrading
To upgrade the CLI to the latest version, you can either run:
Or re-run the installation script:
curl -LsSf https://timbal.ai/install.sh | sh
powershell -ExecutionPolicy ByPass -c "irm https://timbal.ai/install.ps1 | iex"
Uninstallation
To remove the CLI, delete the binary and the ~/.timbal data directory:
rm ~/.local/bin/timbal
rm -rf ~/.timbal
Remove-Item "$env:USERPROFILE\.local\bin\timbal.exe"
Remove-Item -Recurse -Force "$env:USERPROFILE\.timbal"
Python Package
If you want to use Timbal directly in your Python projects or integrate it into an existing codebase, you can install the Python package directly.
Before adding the package, ensure you have python>=3.11 installed.
pip:
Or with uv:
Alternatively, if you want the latest changes and want to experiment with beta features, you can clone the repository and install from source:
git clone https://github.com/timbal-ai/timbal.git
cd timbal
pip install -e .
Next Steps: You’re ready to create your first Timbal project! Continue to the quickstart guide to build your first AI agent. 
