Local Setup

Local Setup

Start the Server

The Windows launcher uses the project virtual environment when it exists:

.\RUN.bat

The local interface is available at http://127.0.0.1:8080.

For verbose local diagnostics, use:

.\DEV.bat

Validate Before Running

.\.venv\Scripts\python.exe app.py --check-config
.\.venv\Scripts\python.exe -m unittest discover -s tests

--check-config validates the module, agent, model, local-LLM, and bridge registries without starting a server or downloading models.

Local Storage

The default local database is SQLite. Runtime data, downloaded models, Hugging Face cache data, PaddleX cache data, evidence files, and vault material are intentionally kept outside the Git commit path.

The main environment variables are:

• SITH_DATA_DIR for database, evidence, logs, and vault output.
• SITH_RUNTIME_DIR for local runtime artifacts.
• SITH_HUGGINGFACE_CACHE_DIR for Hugging Face cache files.
• SITH_PADDLEX_CACHE_DIR for PaddleX cache files.

Use Analysis Models before installing optional model dependencies.