Installation
VritraAI distributes on PyPI as vritraai. Use pip for normal installs; clone only if you are developing the project.
On this page
pip (recommended)
pip install vritraaiThat installs the vritraai console script (entry point vritraai:main). Then:
vritraai ~/projects/my-appPrefer a virtualenv if you manage multiple Python tools: python3 -m venv .venv && source .venv/bin/activate then pip install vritraai.
Requirements
- Python 3.9 or newer
- OS Linux, macOS, or Android (Termux)
- Network for provider APIs (Gemini, OpenRouter, …)
- Dependencies (pulled automatically):
requests,prompt-toolkit,rich(no Rust/`jiter` wheels - Termux friendly)
Termux
pkg install python
pip install -U vritraai
vritraai ~/storage/shared/my-appFrom 1.0.2 onward there is no openai/jiter dependency, so Termux no longer needs a Rust toolchain for install.
From source (contributors)
git clone https://github.com/MrHacker-X/VritraAI.git
cd VritraAI
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
vritraaipip install -e . installs in editable mode so local code changes apply immediately.
Verify
vritraai --help
python -c "import vritraai; print(vritraai.VERSION)"Upgrade / uninstall
pip install -U vritraai
pip uninstall vritraaiRepository layout
| Path | Role |
|---|---|
vritraai.py | Entry / REPL - plain text → agent, /… → commands |
core/agent/ | Loop, LLM, failover, tools, approval, diff preview, memory |
core/agent/tools/ | fs · search · shell · verify · git · todos · project · analysis |
core/commands/ | Slash command implementations |
core/providers/ | Provider registry + catalogs |
core/tui.py | Slash menu, key bindings, suggestions |
core/config_store.py | User config persistence |