Skip to main content
The install step should be boring. Two commands, no surprises.

​
The short path: uv

That’s it. If you don’t have uv yet:
Restart your shell, then uv add bindu. You need Python 3.12 or newer.

​
The pip path

If you’d rather use a standard venv:
If pip install fails, the usual culprit is an old pip. Run python -m pip install --upgrade pip and retry.

​
API keys

To run anything interesting you’ll need a key for at least one LLM provider:
Put them in a .env file at the project root. The examples all use python-dotenv to load it.

​
Verify it worked

You should see a version string (PyPI releases are 0.3.x; source checkouts use CalVer like 2026.21.x.devN+g<sha>). Either way, if it prints, Bindu imported cleanly — head to Your first agent.

​
Hacking on Bindu itself

Different goal — you want to contribute to the framework, not just use it:
The full contributor guide lives at .github/contributing.md. Most of the day-to-day chat happens on Discord — come say hi.