Kuma Voice

Kuma Voice is a self-hosted, watch-only voice assistant prototype. The Watch

off the device and streams a spoken answer back. Optional tools add web search,

This repository does not include a public backend or any credentials. Run your

Start the backend, select an Apple Watch simulator, and press Run.

The checked-in configuration uses http://127.0.0.1:8000 . For a physical Watch

Edit watchos/Local.xcconfig with your own HTTPS backend URL. If the backend has

an API token, put the same value in KUMA_API_TOKEN . This file is ignored by

Git. Local HTTP is allowed for development; remote deployments must use HTTPS.

KUMA_API_TOKEN is optional only for local development. If it is empty, the API

accepts requests without authentication. Always set a long random value when the

The token protects every /api/v1 HTTP and WebSocket endpoint. /health

The included fly.toml deliberately contains no app name or personal region.

then rebuild the Watch app. Use openssl rand -hex 32 to generate a suitable

Provider secrets belong only in backend/.env locally or in your host's secret

store. The full list and safe placeholders are in backend/.env.example .

Set EXA_API_KEY to let the realtime assistant search the web.

Share only the pages Kuma should access with that integration.

Run uv run python -m scripts.google_calendar_auth from backend and save