Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Khai. Personal AI bot for everyone

Khai is a personal AI assistant you install on your own computer. It runs on your machine, knows you over time, and you talk to it via Telegram, the Claude Code command line, or claude.ai/code in the browser.

$20 per month after a 30-day free trial. Pay via PayPal, Venmo, or Zelle. Same product for all users; no feature gates, no upsells.

Domain: khai.bot (fallback: getkhai.com) Support: ai@khai.bot or @getkhai_bot on Telegram Follow: @getkhai on X, Instagram, TikTok, YouTube

What you get

  • Personal Claude on your laptop: a full Claude Code stack (agents, skills, plugins, memory) tailored to who you are
  • Telegram bot frontend: write to your bot from your phone, in voice, text, or photos, in any language
  • Smart routing: when your laptop is open, work runs locally. When asleep, work runs on a fallback server. You never lose access.
  • Weekly background sync: your laptop is the source of truth. Server refreshes automatically every Monday. No manual file copying.
  • Monthly memory consolidation: things Khai learns while running on the server get merged back into your canonical memory.
  • One-click install via Claude Code: a single conversational prompt sets everything up. No terminal commands required.

Who this is for

  • People who want a real personal AI assistant, not a generic chatbot
  • Non-technical users (conversational install, no code editing)
  • Polyglots (Khai mirrors your language: Russian, Ukrainian, English, Spanish, French, German, Portuguese, Italian, Polish, more)
  • Anyone with a Windows 11, macOS, or Linux desktop and an Anthropic Claude subscription

What you need

  1. A computer: Windows 11, macOS, or Linux Desktop. iPhone users only chat via Telegram (the install runs on your computer).
  2. Claude Code installed (free; works with your Anthropic Pro plan).
  3. Anthropic Pro plan ($20/month, billed by Anthropic).
  4. Tailscale account (free tier is fine).
  5. Telegram account (recommended but optional; required for mobile chat).
  6. Google account (recommended for Gmail / Calendar / Drive / Keep auto-discovery).
  7. 15-30 minutes for the install.

Detailed prerequisites: docs/01-prerequisites.md.

Total monthly cost

line item cost
Anthropic Pro $20/month
Khai subscription (after 30-day trial) $20/month
Optional Fly.io cloud server (free tier covers most) $0-5/month
Total $40-45/month

You pay Anthropic and Fly directly; we charge the $20/month for Khai itself.

Read the docs in order

  1. Overview and architecture
  2. Prerequisites checklist
  3. Create your personal Telegram bot
  4. Pick your server strategy
  5. Deploy the server (laptop-only, BYOC, Fly.io cloud, or claude.ai Projects)
  6. Customize agents and personality
  7. Set up Google OAuth
  8. Build the installer bundle
  9. Run the install on the user's machine
  10. Troubleshooting
  11. Extending: add new connectors and agents
  12. Telemetry and licensing (paid model details)
  13. Cloud auto-deploy on Fly.io
  14. Silent install mode
  15. Multilingual install
  16. Auto-discovery from Gmail and Telegram
  17. Default agents and skills
  18. Onboarding after install
  19. claude.ai Projects fallback
  20. Questionnaire (full question list)
  21. Self-healing and bypass permissions

Architecture spec: specs/2026-05-09-khai-v2.1-architecture.md Russian version: specs/2026-05-09-khai-v2.1-architecture-RU.md Brand assets: specs/brand-assets.md

Real-world example

The first end-to-end deployment of this architecture built a personal Khai for a non-technical user who leads a CRM team at work and writes poetry on the side. Read the full case study: docs/case-study-anonymized.md.

Starter template

A reusable, parameterized version of all the code lives in starter-template/. Adapt for your end user.

License

Proprietary. Source-available for internal review only. Commercial use requires the $20/month subscription.

Status

v2.1 architecture (May 2026). Implementation in progress. v2.2 features planned: Strava, Spotify, Slack connectors; macOS code signing; in-app feedback widget; community Discord.

Releases

Packages

Contributors

Languages