FAQ and Troubleshooting
Which installer should I download?
There are two macOS installers: the Apple Silicon build for Macs with M-series chips, and the Intel build for Intel-based Macs. Check your chip in the Apple menu under About This Mac. Windows users should download the Windows installer. On x86_64 Linux, choose AppImage for a portable package, DEB for Debian/Ubuntu-based distributions, or RPM for Fedora/RHEL-based distributions.
Why can't I use the official Kimi models?
Official models require signing in with a Kimi account, and accounts without a Kimi membership cannot use the official models directly; available models also vary by membership plan. Open the membership entry from the account area to review plans, and see Membership Benefits and Model Configuration. Alternatively, you can connect a third-party model provider.
What if a third-party model does not work?
Open the Model Providers area in Settings and check that the API key, base URL, and model information are correct. Save the configuration, switch to the model in the Composer, and send a read-only task to confirm it works. For the complete setup steps, see Connect a third-party model provider.
Why can't I send a message?
An empty session must have a workspace before you can send a message. Click the folder name above the Composer to choose a recent folder or add a new workspace, then send your message. For other ways to add a workspace, see Workspace management.
How do I export diagnostics?
Choose Help → Export Diagnostics… in the app menu, or select the same entry in the desktop app's system-tray menu. The exported ZIP is saved to your system Downloads folder and includes logs, startup state, white-screen snapshots, and local crash reports from the last 30 days for troubleshooting startup failures, internal errors, and unexpected exits.
The app shows a loading page during startup. If startup is slow or fails, you can also export diagnostics, open the log folder, or restart the app from that page. Attach the exported diagnostic package when reporting a problem to support.
Where can I get help with other issues?
- Error Reference: look up the meaning and handling of error codes.
- FAQ: read product-level frequently asked questions.
- Contact & Feedback: get help through the community or feedback channels.