Local Development

cp api/config.example.yml api/config.yml
# Edit database.url, redis.url, etc.

database:
  url: "postgresql://postgres:postgres@localhost:5432/kair_voice"
app:
  base_url: "0.0.0.0:8000"
  uploads_dir: "./uploads"
redis:
  url: "redis://localhost:6379"
transcription:
  client: "local"
  realtime_model: "ai_models/ggml-base.bin"
  final_model: "ai_models/ggml-base.bin"
  nr_of_threads_for_transcription: 4
  uploads_dir: "./uploads"

mkdir -p api/uploads

cd api
cargo run --bin kair-voice-web-app
# API available at http://localhost:8000
# Swagger UI at http://localhost:8000/swagger

# Transcription worker
cd api
CONFIG_PATH=./config.yml cargo run --bin kair-voice-transcription-worker

# Summarisation worker
CONFIG_PATH=./config.yml cargo run --bin kair-voice-summarisation-worker

# HiRAG worker (optional)
CONFIG_PATH=./config.yml cargo run --bin kair-voice-hirag-worker

cd ui/web
pnpm install
pnpm dev
# Frontend at http://localhost:5173

cd api
docker compose up

cd api
cargo run --bin kair-voice-web-app -- --migrate-only

RUST_LOG=debug cargo run --bin kair-voice-web-app
RUST_LOG=debug CONFIG_PATH=./config.yml cargo run --bin kair-voice-transcription-worker

./manage-workers.sh start         # start all (3 transcription + 3 summarisation)
./manage-workers.sh stop          # graceful stop (30s timeout)
./manage-workers.sh restart       # stop + start
./manage-workers.sh status        # check running workers
./manage-workers.sh restart transcription   # restart one type only