- TypeScript 43%
- Go 35%
- Kotlin 20%
- CSS <1%
- Nix <1%
- 3 more languages <1%
Kairos #
Kairos is a simple focused chat app for talking to LLMs.
It is a lightweight open WebUI alternative for hosted models only: no local model runtime, no heavyweight deployment, just a fast web UI and a Go server you can run as a single service.
Screenshots #
Desktop chat |
Tool activity and sources |
Android chat |
Android assistant |
Desktop app #
A Linux desktop app with a tray icon and a global hotkey is available from the releases page. See desktop/README.md to install it.
Run locally #
pnpm install
pnpm dev
Copy .env.example to .env first if you want to override local defaults. pnpm dev starts the Vite frontend on http://localhost:3000 and the Go backend on http://localhost:8080.
Android app #
The Android app connects to your Kairos server and supports an optional system assistant overlay. See Android installation and usage.
Guides #
- Import ChatGPT conversations
- Export conversations
- Connect remote MCP tools
- Model information and pricing
- Contributing
Configuration #
Local environment values live in .env.
Common settings:
APP_ENV:development,test, orproductionHTTP_ADDR: server bind addressKAIROS_DB_PATH: SQLite database pathMAX_TOOL_CALLS: default maximum tool-call rounds per responseAUTH_ENABLED: enable authenticationALLOW_SIGNUP: allow self-service signupALLOW_REMOTE_IMPORT: allow conversation imports from remote clients (default:false)PROVIDER_SECRET_KEY: encryption key for stored provider and tool credentialsBOOTSTRAP_ADMIN,ADMIN_EMAIL,ADMIN_PASSWORD: initial admin accountASSET_STORAGE: image storage backend —inline(default),local, ors3
Production requires authentication, secure session cookies, and a
PROVIDER_SECRET_KEY of at least 32 characters.
See .env.example for all settings, including local image paths and S3 options.
Production Build #
pnpm build
go build ./cmd/kairosd
pnpm build writes the frontend bundle into internal/server/static, and the Go binary embeds those assets. The final binary serves both the SPA and /api/* from the same origin.
Credits #
The original interface was extracted and adapted from webclaw by ibelick.
License #
See LICENSE.



