Quickstart
Download, install, and get started with Kunkun.
Download
Kunkun current release target is macOS only.
| Platform | Status |
|---|---|
| macOS | ✅ Available |
| Windows | 🟡 In Progress |
| Linux | 🟡 In Progress |
| HarmonyOS | 🕒 Planned |
macOS
Available now — download the .dmg for Apple Silicon or Intel.
Windows
In Progress — installer is not yet released.
Linux
In Progress — AppImage and .deb are coming soon.
HarmonyOS
Planned — roadmap item.
First launch
Open Kunkun
After installation, launch Kunkun from your Applications folder / Start menu. You'll see the launcher window — a search bar at the top of your screen.
The default shortcut to toggle the launcher is Ctrl+Space (or Cmd+Space on macOS if no conflict).
Try the basics
Start typing to search:
- Applications — type
termto find Terminal,calcfor Calculator - Files — type
~/Documentsto navigate folders - Web — type
gh kunkunto search GitHub - Calculator — type
= 42 * 7to compute
Use Enter to select the first result, or use the arrow keys to navigate.
Open Settings
Press Cmd+, (macOS) or Ctrl+, (Windows/Linux), or type settings in the launcher and press Enter.
From here you can configure:
- AI Search — create knowledge bases and index your data
- API Keys — enable the local HTTP server and create access tokens
- Developer — load extensions during development
- Logs — view and export logs and crash reports
The Settings window is also where you install extensions from the store and manage your AI models.
Next steps
| If you want to… | Go here |
|---|---|
| Build a knowledge base and search it with AI | AI Search |
| Access Kunkun features from external tools | Local API Server |
| Connect AI Search to MCP-compatible clients | AI Search MCP |
| Build your own extension | Switch to Developer Guide |