Kimi Desktop

Unofficial desktop client for Kimi AI
Built with Electron • Offline-capable • Privacy-focused

Features • Downloads • Installation • Usage • Shortcuts • Development

---

✨ Features

Core Experience

• 🌐 Native Desktop Wrapper — Seamless Kimi AI experience with system tray integration and native window controls
• 💾 Persistent Sessions — Stay logged in with encrypted local storage of credentials
• 🔄 Auto-Recovery — Intelligent retry logic with exponential backoff for connection issues

Offline Capabilities (v3.0)

• 📚 Conversation History — Automatic local storage of all conversations using IndexedDB
• 🔌 Offline Mode — Continue accessing and searching past conversations without internet
• 🔑 API Integration — Direct Moonshot API support for offline chat with your own API key
• 📤 Import/Export — Backup and restore your conversation history as JSON

Privacy & Security

• 🔒 Context Isolation — Sandboxed webview with disabled Node.js integration
• 🛡️ Content Security Policy — Strict CSP headers preventing XSS attacks
• 🔐 Local API Key Storage — Encrypted-at-rest API credentials
• 🧹 Data Control — Granular clearing of cache, cookies, history, or all data

Productivity

• ⚡ Keyboard Shortcuts — Full keyboard navigation support
• 📐 Window Persistence — Remembers size, position, and maximized state
• 🎯 Deep Linking — kimi:// protocol support for opening specific conversations
• 🔔 Desktop Notifications — Optional alerts for new messages

---

📥 Downloads

Download the latest version from the Releases page.

Platform	Download	Notes
Windows	.exe (Installer)	Windows 10/11, auto-updates supported
Linux	.AppImage	Portable, works on most distributions
	.deb	Debian, Ubuntu, Mint
	.rpm	Fedora, RHEL, openSUSE
	.snap	Ubuntu Snap Store

Note: macOS is not currently supported. If you're a Mac user, consider using the web version at kimi.com or building from source.

System Requirements

• Windows: Windows 10 version 1809 or later
• Linux: Ubuntu 18.04+, Fedora 32+, or equivalent with glibc 2.31+

---

🚀 Installation

Windows

1. Download Kimi-Desktop-Setup-x.x.x.exe from Releases
2. Run the installer (administrator rights not required for user install)
3. Launch from Start Menu or Desktop shortcut

SmartScreen Warning: Windows may show a SmartScreen warning since the app is not code-signed with an expensive EV certificate. Click "More info" → "Run anyway" to proceed.

Linux

AppImage (Recommended - Works everywhere)

# Download
wget https://github.com/Virusilvester/kimi-desktop/releases/download/v3.0.0/Kimi-Desktop-3.0.0.AppImage

# Make executable
chmod +x Kimi-Desktop-3.0.0.AppImage

# Run
./Kimi-Desktop-3.0.0.AppImage

Debian/Ubuntu (.deb)

sudo dpkg -i kimi-desktop_3.0.0_amd64.deb
sudo apt-get install -f  # Fix dependencies if needed

Fedora/RHEL (.rpm)

sudo rpm -i kimi-desktop-3.0.0.x86_64.rpm

Snap Store

sudo snap install kimi-desktop

---

🎮 Usage

First Launch

1. Sign in to your Kimi account (webview)
2. (Optional) Add your Moonshot API key in Settings → API Key for offline chat
3. Start chatting — conversations auto-save locally

Offline Mode

When internet disconnects:

• 🟡 Yellow indicator appears in title bar
• 📂 Access all saved conversations via sidebar (Ctrl+Shift+S)
• ✏️ Continue chatting if API key is configured (responses via Moonshot API)
• 🔄 Auto-reconnect when network returns

Conversation Management

• Search (Ctrl+Shift+S): Find any message across all conversations
• Filter: View all or offline-only conversations
• Export: Backup as JSON via Settings → General
• Delete: Individual conversation removal with confirmation

---

⌨️ Keyboard Shortcuts

Shortcut	Action
Ctrl/Cmd + R	Reload page
Ctrl/Cmd + Shift + R	Force reload (ignore cache)
Ctrl/Cmd + +	Zoom in
Ctrl/Cmd + -	Zoom out
Ctrl/Cmd + 0	Reset zoom
Ctrl/Cmd + Shift + S	Toggle conversation sidebar
Ctrl/Cmd + ,	Open Settings
Ctrl/Cmd + W	Close window (minimize to tray)
Ctrl/Cmd + Q	Quit application

---

🛠️ Development

Prerequisites

• Node.js 18.x or later
• npm 9.x or later (or yarn/pnpm)

Setup

# Clone repository
git clone https://github.com/Virusilvester/kimi-desktop.git
cd kimi-desktop

# Install dependencies
npm install

# Run in development mode (hot reload)
npm run dev

# Build for production
npm run build

# Package for distribution
npm run release:win    # Windows
npm run release:linux  # Linux

Project Structure

kimi-desktop/
├── src/
│   ├── main/           # Electron main process (IPC, window management)
│   ├── preload/        # Preload scripts (secure bridge)
│   └── renderer/       # React frontend (UI components)
├── build/              # Build resources (icons, entitlements)
├── resources/          # Static assets
└── electron.vite.config.ts  # Build configuration

Tech Stack

• Electron — Cross-platform desktop framework
• Vite — Fast build tooling and HMR
• React 18 — UI framework with TypeScript
• IndexedDB — Client-side conversation storage
• electron-builder — Distribution packaging

---

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📜 License

Distributed under the MIT License. See LICENSE for more information.

---

🙏 Acknowledgments

• Electron — Cross-platform desktop apps
• Moonshot AI — Kimi AI platform
• electron-vite — Modern Electron build tooling
• Icons by Heroicons

---

_{Built with ❤️ by Virusilvester}