🧰 Prerequisites & Setup

1. Install UV for Package Management

macOS

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Create a Virtual Environment

uv venv

3. Activate the Environment

macOS

source .venv/bin/activate

Windows

.venv\Scripts\activate.ps1

4. Install Dependencies

uv sync

---

5. Configure Environment Variables

cp .env.example .env

update the .env file with your values (API Keys, Snowflake credentials, etc.).

---

🚀 Start the Project

fastapi dev main.py

---

🐳 Interpreter Service (Docker)

Build and run the interpreter service Docker image:

docker build -f interpreter/Dockerfile -t othelia-interpreter .
docker run -p 8001:8001 othelia-interpreter

Note: this is a required tool of the analysis agent