Local development
Run Soriku in dev mode with hot-reload for the engine code. Useful when you're working on the engine itself or testing a fork.
Hot reload
# Uvicorn watches the codebase
uvicorn server:app --reload --host 0.0.0.0 --port 8765
Hot reload restarts the engine on file change, which means model state is dropped. For agent persona work that doesn't touch engine code, use the regular
python server.py and edit personas live.Run the test suite
python -m pytest tests/ -v
# subset
python -m pytest tests/test_smart_router.py -v
Soriku ships with ~500 tests. Run the full suite before sending a PR. Individual test modules are useful while iterating.
Dev-only env vars
| Variable | Effect |
|---|---|
SORIKU_DEV=1 | Verbose logging, exposes /_debug routes |
SORIKU_NO_BENCHMARK=1 | Skip benchmark autorun on startup |
SORIKU_USE_FAKE_OLLAMA=1 | Use the fake Ollama backend for tests |