Skip to main content
The install step should be boring. You should be able to get Bindu into your environment, verify that it works, and move on to building the agent.

​
Why This Matters

The first setup step sets the tone for the rest of the experience. If installation is messy, everything after it gets harder. If it is clean, you get to the part that actually matters much faster.
This page covers two install paths: uv if you want the shortest route, and pip if you prefer a standard virtual environment workflow.

​
How To Install Bindu

You can install Bindu with uv or pip. uv is the recommended path. 
uv add bindu

Recommended Path

uv is the shortest way to add Bindu and keep dependency management simple.

Standard Path

If your workflow already uses pip and virtual environments, that still works fine.

​
The Setup Flow

1

Use uv

If you already use uv, install Bindu directly:
uv add bindu
2

Use pip

If you want a traditional virtual environment setup, create one first and then install Bindu.
python3 -m venv ~/.venvs/bindu
source ~/.venvs/bindu/bin/activate
pip install -U bindu
3

Fix Common Installer Issues

If installation fails, update pip and retry:
python -m pip install --upgrade pip

​
Contributing

If you want to work on Bindu itself, set up the development environment from the repository. 
# Clone the repository
git clone https://github.com/getbindu/Bindu.git
cd Bindu

# Install development dependencies with uv
uv sync

# Install pre-commit hooks
pre-commit run --all-files
Each command has a specific job:
  • git clone gets the source locally
  • cd Bindu moves into the repository
  • uv sync installs the development dependencies
  • pre-commit run --all-files runs the configured code-quality checks
See our Contributing Guidelines for more details.

​
Practical Notes

Use uv if you want the recommended path and a shorter setup flow:
uv add bindu
Use pip if your local workflow already depends on a standard Python virtual environment.
python3 -m venv ~/.venvs/bindu
source ~/.venvs/bindu/bin/activate
pip install -U bindu
Update pip first and try again:
python -m pip install --upgrade pip
Clone the repository, sync dependencies, and run the pre-commit checks:
git clone https://github.com/getbindu/Bindu.git
cd Bindu
uv sync
pre-commit run --all-files
Sunflower LogoBindu keeps the first stepsimple enough to start fast, so you can spend your time building agents instead of babysitting setup.