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

VariablePurpose
VRITRA_APPROVALask · auto · safe
VRITRA_RESET_TRUST1 forget folder trust
VRITRA_AGENT_MAX_ITERMax turns (default 32)
VRITRA_MODEL_TIMEOUTSeconds per model call (default 120)
VRITRA_AGENT_STREAM0 disable narration stream

Failover strategy

  1. Configure at least two free providers (e.g. Gemini + Groq, or Gemini + OpenRouter free).
  2. Keep paid OpenRouter models off the default if you have no credits.
  3. On blocked finish, read the suggested free /model picks 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.