Installation

VritraAI distributes on PyPI as vritraai. Use pip for normal installs; clone only if you are developing the project.

pip (recommended)

pip install vritraai

That installs the vritraai console script (entry point vritraai:main). Then:

vritraai ~/projects/my-app

Prefer 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-app

From 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 .
vritraai

pip 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 vritraai

Repository layout

PathRole
vritraai.pyEntry / 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.pySlash menu, key bindings, suggestions
core/config_store.pyUser config persistence