Advanced usage
Power-user patterns for long tasks, env tuning, and development installs.
Writing better objectives
- Name paths explicitly (
site/,app/main.py) - Define done: tests green, README present, no stubs
- Split huge epics into sequential prompts if you hit iteration limits
Add POST /items to app/main.py with pydantic validation.
Update tests/test_items.py and run pytest -q.
Do not touch unrelated modules.Environment knobs
| Variable | Purpose |
|---|---|
VRITRA_APPROVAL | ask · auto · safe |
VRITRA_RESET_TRUST | 1 forget folder trust |
VRITRA_AGENT_MAX_ITER | Max turns (default 32) |
VRITRA_MODEL_TIMEOUT | Seconds per model call (default 120) |
VRITRA_AGENT_STREAM | 0 disable narration stream |
Failover strategy
- Configure at least two free providers (e.g. Gemini + Groq, or Gemini + OpenRouter free).
- Keep paid OpenRouter models off the default if you have no credits.
- On blocked finish, read the suggested free
/modelpicks and switch.
Contributor workflow
git clone https://github.com/MrHacker-X/VritraAI.git
cd VritraAI
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
pip install ruff
ruff check .
vritraai .CI expectations
Upstream CI runs lint, package install, and an import smoke test on Python 3.9–3.13. Run ruff check . before opening a PR.