BoosAPI Desktop
English | 简体中文
A local-first AI desktop client for the Boos ecosystem — multi-provider chat, AI agents, knowledge base, MCP, and a built-in API gateway, in one app.
What is BoosAPI Desktop
BoosAPI Desktop is a desktop AI workspace that runs on your own machine. It ships with BoosAPI (https://api.boos.lat) wired in as the default provider, so you can start chatting immediately, while staying free to connect any other OpenAI-compatible endpoint. Your conversations, keys, and files live locally.
Features
Chat & models
- Multi-provider chat — Connect BoosAPI, OpenAI, Claude, Gemini, DeepSeek, Qwen, and any OpenAI-compatible endpoint, with custom base URL, API path, headers, and proxy rules.
- Provider onboarding — Import provider profiles via
boosapi://deep links and CC Switch config import, applied after your confirmation. - Model management — Sync remote model lists, manage groups, test latency, and configure capability tags, context length, sampling defaults, reasoning profiles, and per-model
extra_body. - Conversation workflow — Streaming replies, reasoning blocks, message versions, conversation branching, title generation, long-conversation compression, and multi-model parallel answers.
AI agent
- Agent mode — Let models read/edit files, run commands, and analyze code inside a controlled desktop workflow.
- Permission control — Choose standard review, auto-accept edits, or full-access mode, with working-directory sandbox checks.
- Approval & cost panel — Watch tool calls live, remember allow decisions, and track tokens and cost per agent session.
Content rendering
- Markdown & math — Render Markdown, code highlighting, tables, task lists, and LaTeX inline during streaming.
- Code, diagrams & artifacts — Built-in Monaco code blocks, Mermaid, D2 diagrams, and an artifact panel for code, notes, reports, and previews.
- HTML fragment rendering — Safely preview model-generated HTML fragments with streaming-stability fixes.
Search & knowledge
- Web search — Plug in Tavily, Zhipu WebSearch, Bocha, and more, with source citations and search-query generation.
- Local knowledge base — Index private documents with sqlite-vec, configure retrieval/rerank options, and inspect retrieval feedback.
- Context management — Attach files, search results, knowledge snippets, memory, and tool output to conversation context.
Tools & extensions
- MCP protocol — Run Model Context Protocol servers over stdio, SSE, or StreamableHTTP transports.
- Built-in tools — Use built-in MCP tools like fetch and file search without installing separate servers.
- Tool-loop limits — Configure a max tool-call loop count and recover interrupted or stuck tool sessions.
API gateway
- Local gateway — Expose OpenAI Chat Completions, OpenAI Responses, Claude-native, and Gemini-native APIs from the desktop app.
- Access & observability — Manage gateway keys, SSL/TLS certificates, request logs, and usage stats locally.
- Client templates — Ready-made config templates for Claude Code, Codex CLI, OpenCode, Gemini CLI, and custom clients.
Data import & backup
- Third-party import — Import ChatGPT exports, Cherry Studio backups, and Kelivo backups, with preview stats, warnings, and duplicate handling.
- Provider & file migration — Cherry Studio / Kelivo import can optionally migrate linked providers, API keys, and file attachments.
- Backup — Back up and restore via a local directory, WebDAV, or S3-compatible storage.
Desktop experience & security
- Local encryption — App state lives in
~/.boosapi/, user files in~/Documents/BoosAPI Desktop/, and API keys are protected with AES-256 and a local master key. - Desktop integration — Tray, always-on-top, global shortcuts, autostart, proxy settings, and update checks.
- 11 UI languages — Switch between Simplified Chinese, Traditional Chinese, English, Japanese, Korean, French, German, Spanish, Russian, Hindi, and Arabic.
Platform support
| Platform | Architecture |
|---|---|
| macOS | Apple Silicon (arm64), Intel (x86_64) |
| Windows 10/11 | x86_64, arm64 |
| Linux | x86_64 (AppImage/deb/rpm), arm64 (AppImage/deb/rpm) |
Quick start
Download the build for your platform from the Releases page. On first launch, BoosAPI is preconfigured as the default provider — add your key in Settings and start chatting.
Build from source
# Frontend deps
pnpm install
# Build the bundled renderer packages (first time only)
pnpm --dir libs/stream-monaco install && pnpm --dir libs/stream-monaco build
pnpm --dir libs/markstream-vue install && pnpm --dir libs/markstream-vue run build:parser
pnpm --dir libs/markstream-vue/packages/markstream-react build
# Run in dev / produce a bundle
pnpm tauri dev
pnpm tauri build
Requires Rust (stable), Node 20+, pnpm, and the Tauri Linux system dependencies (webkit2gtk-4.1, libsoup-3.0) on Linux.
FAQ
macOS says the app is "damaged" or "from an unidentified developer"
The app is not signed by Apple, so macOS may warn you. Remove the quarantine attribute:
sudo xattr -dr com.apple.quarantine "/Applications/BoosAPI Desktop.app"
Then open it from System Settings → Privacy & Security and click Open Anyway if prompted.
License
BoosAPI Desktop is a fork of AQBot, used and relicensed with the author's permission. It bundles the MIT-licensed open-agent-sdk. See LICENSE.