Skip to content
Golavo

Build from source

Prerequisites

Section titled “Prerequisites”
  • Python 3.12+ (the core pins scipy==1.18.0, which requires 3.12)
  • Node 22+
  • Rust stable + the Tauri prerequisites for your OS (desktop builds only)

Clone & run in your browser

Section titled “Clone & run in your browser”
Terminal window
git clone https://github.com/udhawan97/Golavo.git
cd Golavo
cp .env.example .env      # optional; every key is optional
make setup                # install core + server + ui dev dependencies
make dev                  # starts both services and opens 127.0.0.1:5173
make test                 # run the test suite
make lint                 # ruff (python) + oxlint (ui)

make dev keeps the FastAPI service on 127.0.0.1:8000, points the Vite UI at that local service, and opens http://127.0.0.1:5173. Press Ctrl+C to stop both. Use python scripts/dev.py --no-open when you do not want a browser tab opened automatically.

Windows PowerShell without make

Section titled “Windows PowerShell without make”
Terminal window
git clone https://github.com/udhawan97/Golavo.git
Set-Location Golavo
Copy-Item .env.example .env
python -m pip install -e "core[dev]" -e "server[dev]"
npm --prefix ui install
python scripts/dev.py

The Python launcher automatically uses npm.cmd on Windows and stops both services when you press Ctrl+C. Git Bash or WSL can use the shorter make setup / make dev path above.

Build the current desktop source

Section titled “Build the current desktop source”

Browser source mode includes the read paths and My Teams. Trust Center archive restore and checkpoint creation additionally require the desktop source build’s private launch token. After installing Rust and the Tauri prerequisites for your OS, build the bundle from the repository root:

Terminal window
packaging/build.sh aarch64-apple-darwin      # macOS Apple Silicon
# or: packaging/build.sh x86_64-pc-windows-msvc

Open the resulting local app, then use Settings → Proofs, backups & local integrity or the footer’s Trust Center link. The complete bundle/output notes are in Installation → Build the desktop app locally.

Repository layout

Section titled “Repository layout”
Path What License
core/ Python modeling library Apache-2.0
server/ FastAPI app Apache-2.0
ui/ React + TypeScript + Vite Apache-2.0
desktop/ Tauri 2 shell Apache-2.0
docs-site/ this documentation site docs