Development

Разработка

Окружение

python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"      # dev = ruff + pytest (и др.)

Требуется Python 3.11+.

LLM‑провайдер

LLM_PROVIDER выбирает бэкенд (по умолчанию stub — полностью офлайн, безетапный JSON‑вывод, идеален для CI/демо):

Провайдер	Переменные	Требования
stub	LLM_PROVIDER=stub	по умолчанию, ничего не нужно
openrouter	OPENROUTER_API_KEY, OPENROUTER_MODEL=openrouter/free	ключ OpenRouter

(Ранее поддерживались ollama/openai — мигрировано на OpenRouter, см. #46.)

Проверка

ruff check .
ruff format --check .
pytest                       # 174 passed, 2 skipped
NEREUS_RUN_LIVE=1 pytest     # + live‑интеграционные с OpenRouter (и ключом)

Live‑тесты включаются только при NEREUS_RUN_LIVE=1, чтобы CI оставался офлайн‑детерминированным.

Хранилище и ветвление

CI (.github/workflows/ci.yml) запускает ruff + pytest на push/PR в develop и main. develop — fast lane; main — release gate (правила контроля доступа репо‑rulesетом, см. CLAUDE.md).