Installation
git clone https://github.com/zlatko-lakisic/comstar.git
cd comstarVendor submodules (AO / Reach) may need:
git submodule update --init --recursivecd terminal/bridge
dart pub get
dart compile exe bin/comstar_bridge.dart -o /usr/local/bin/comstar-bridgeOn Mac bring-up, prefer make bridge-dev instead of installing a system binary.
cd terminal/audio
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txtcd terminal/kiosk
# Static files; production is served by the bridge HTTP :8776
# Dev:
# make kiosk-dev → http://127.0.0.1:5173/The bridge registers client.* agents with the AO daemon at session start from overlays/comstar/agent_providers/*.yaml. These are ephemeral — they exist for the life of the session and are not mounted on the host.
Ensure the AO daemon has:
export AGENTIC_SERVE_SESSION_OVERLAY=1
export AGENTIC_SERVE_MCP_TUNNEL=1# Prefer Python 3.12 for faster-whisper
python3.12 -m venv .venv-stt && source .venv-stt/bin/activate
pip install -r scripts/requirements-stt.txt
make stt-dev # :8090
python3 scripts/tts_server.py # :8091
export COMSTAR_STT_URL=http://127.0.0.1:8090
export COMSTAR_TTS_URL=http://127.0.0.1:8091Production prefers Ada speech via Reach — see Speech and ADR 0003.
systemctl --user enable --now comstar-bridge comstar-audio comstar-kiosk
# Optional until Ada speech is proven:
# systemctl --user enable --now comstar-stt comstar-ttsEnable linger once:
sudo loginctl enable-linger $USERUnit files: deploy/systemd/. Deploy helper: make deploy / deploy/deploy.sh.
cp config/comstar.example.yaml config/comstar.yaml
# set orchestration.base_url, vision.codeproject_url, tokenNever commit real comstar.yaml, comstar.dev.yaml, or comstar.mac.env.
make doctor
make testHealth table: Runbook § Health checks.