[READ-ONLY] Mirror of https://github.com/thang-qt/Kairos. Focused LLM chat client
README.md

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 #

Focused desktop chat with tables and rich text
Desktop chat
Desktop research conversation with tool activity and sources
Tool activity and sources
Kairos chat on Android
Android chat
Kairos assistant overlay answering a question about another app
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 #

Configuration #

Local environment values live in .env.

Common settings:

  • APP_ENV: development, test, or production
  • HTTP_ADDR: server bind address
  • KAIROS_DB_PATH: SQLite database path
  • MAX_TOOL_CALLS: default maximum tool-call rounds per response
  • AUTH_ENABLED: enable authentication
  • ALLOW_SIGNUP: allow self-service signup
  • ALLOW_REMOTE_IMPORT: allow conversation imports from remote clients (default: false)
  • PROVIDER_SECRET_KEY: encryption key for stored provider and tool credentials
  • BOOTSTRAP_ADMIN, ADMIN_EMAIL, ADMIN_PASSWORD: initial admin account
  • ASSET_STORAGE: image storage backend — inline (default), local, or s3

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.