Skip to main content

​
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:
If your system doesn’t have curl, you can use wget:
The installation script may be inspected before use:
Alternatively, the installer or binaries can be downloaded directly from GitHub.

​
Upgrading

To upgrade the CLI to the latest version, you can either run:
Or re-run the installation script:

​
Uninstallation

To remove the CLI, delete the binary and the ~/.timbal data directory:

​
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.
Using 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:
Next Steps: You’re ready to create your first Timbal project! Continue to the quickstart guide to build your first AI agent.