Sandbox
@ThinkInAIXYZ/deepchat

Desktop AI client for MCP, Skills, and session tape

DeepChat is an Electron desktop client for running AI agent sessions with tools, Skills, MCP servers, and ACP agents. It stores session history as Tape so you can review what happened, resume work, and inspect tool calls and model metadata later. It also supports remote control from messaging apps and imports Skills that work across several agent tools.

6,316 stars729 forksTypeScriptUpdated 7d ago
Who it's for

Builders who want a local desktop app for agent-led work, reusable Skills, and tool connections across several AI systems.

What it delivers

You can keep agent work in one place, reconnect tools and Skills, and resume sessions without re-explaining everything.

What it does

Session tape and trace

Records structured session history, tool calls, provider metadata, and token budgets so you can review or resume past work.

Skills support

Installs Skills from folders, ZIP files, or URLs and lets you enable them per conversation for task-specific behavior.

ACP agent integration

Lets ACP-compatible agents appear as selectable entries in the model picker and run inside the desktop app.

MCP support

Connects to MCP Resources, Prompts, and Tools over transports like StreamableHTTP, SSE, and Stdio, with one-click installation.

Remote control

Lets you manage sessions from Telegram, Feishu/Lark, QQBot, Discord, and WeChat iLink.

Multi-model support

Works with OpenAI, Gemini, Anthropic, DeepSeek, Ollama, Grok, and many other providers through one interface.

Local-first desktop UI

Uses Electron for a native Windows, macOS, and Linux app with multi-window and multi-tab session management.

How to get it

  1. 1For macOS users, you can install DeepChat using Homebrew
    brew install --cask deepchat
  2. 2Run
    $ pnpm install
    $ pnpm run installRuntime
    # if got err: No module named 'distutils'
    $ pip install setuptools

README

DeepChat AI Assistant Icon

DeepChat - Open-Source Local-First AI Agent Desktop Client

DeepChat is an open-source, local-first AI agent desktop client with rich agent capabilities, designed around the Tape.systems philosophy, with support for MCP, Skills, ACP, and remote control integrations for messaging apps.

Stars Badge Forks Badge Pull Requests Badge Issues Badge License Badge Downloads Ask DeepWiki

ThinkInAIXYZ%2Fdeepchat | Trendshift

❤️ Sponsor

APIMart Thanks to APIMart for sponsoring this project! APIMart is a low-cost API platform for AI image & video generation — GPT-Image-2 from $0.006/image, 160+ images per dollar. One async API covers both image and video: submit a task, get an ID, fetch results via polling or callback. Batch tens of thousands of images without timeouts, switch models without changing code. Pay-as-you-go with no monthly fee — sign up here to get started.
OpenModel Thanks to OpenModel for sponsoring this project! OpenModel offers client-specific discounts of up to 90% for Codex and 60% for Claude Code across supported models, helping developers cut API costs without changing how they work. Just connect your OpenModel API key and keep using Codex or Claude Code as usual — supported clients are detected automatically and discounted routes are applied with no extra parameters or manual routing required. You can also configure fallback behavior per API key, choosing whether to continue at standard pricing or stop when a discounted route is temporarily unavailable. DeepChat users can register via this link.
PackyCode PackyCode is a stable, high-performance API relay provider, offering relay services for Claude Code, Codex, Gemini, and more. With automatic failover, smart routing, and unlimited concurrency, it turns AI into a real productivity tool. Register via this link and get started!

📑 Table of Contents

🚀 Project Introduction

DeepChat is a powerful open-source, local-first AI agent desktop client that brings together models, tools, Skills, agent runtimes, Tape, and long-running sessions in one desktop app. Whether you're using cloud APIs like OpenAI, Gemini, Anthropic, or locally deployed Ollama models, DeepChat delivers a smooth user experience.

DeepChat's sessions and agent processes follow the Tape.systems philosophy: keep the process, so context, tool calls, requests, and results stay recoverable, traceable, and inspectable. It also provides strong MCP support, installable Skills, ACP agent integration, and remote control for Telegram, Feishu/Lark, QQBot, Discord, WeChat iLink, and other messaging workflows.

DeepChat Light Mode
DeepChat Dark Mode

💡 Why Choose DeepChat

Compared to other AI tools, DeepChat offers the following unique advantages:

  • Local-First Agent Desktop Client: Run DeepChat agents, ACP agents, and remote-ready bots in one local app
  • Tape.systems Philosophy: Preserve recoverable session history, trace request context, and inspect token budgets when agent work gets complex
  • Skills That Travel: Install, import, export, and enable reusable Skills per conversation for code review, documents, frontend work, Office/PDF tasks, and more
  • Native ACP Integration: Run ACP-compatible coding and task agents as first-class entries in the model selector
  • Strong MCP Support: Support Resources, Prompts, Tools, multiple transports, inMemory services, and one-click installation
  • Remote-Ready Workflows: Control DeepChat sessions from Telegram, Feishu/Lark, QQBot, Discord, and WeChat iLink
  • Unified Multi-Model Management: One application supports mainstream cloud LLMs and local Ollama models, eliminating the need to switch between multiple apps
  • Privacy-Focused: Local data storage and network proxy support reduce the risk of information leakage
  • Business-Friendly: Embraces open source under the Apache License 2.0, suitable for both commercial and personal use

🔥 Main Features

  • 🤖 Local-First Agent Desktop Client
    • Select DeepChat, ACP, and remote-capable agents from one model-like entry point
    • Run long-lived sessions with project folders, permission modes, tool output, and resumable context
  • 📼 Tape & Trace
    • Session Tape records structured work history for recovery, resume, and future agent memory flows
    • Trace previews show request sequences, provider/model metadata, Tape view manifests, included entries, and token budgets
  • 🧠 Skills
    • Install Skills from folders, ZIP files, or URLs
    • Enable Skills per conversation so DeepChat can load task-specific instructions, references, and optional scripts
    • Import and export Skills with Claude Code, Codex, Cursor, Windsurf, GitHub Copilot, and other compatible tools
  • 🤝 ACP (Agent Client Protocol) Agent Integration
    • Run ACP-compatible agents (built-in or custom commands) as selectable “models”
    • ACP workspace UI for structured plans, tool calls, and terminal output when provided by the agent
  • 📡 Remote Control
    • Control DeepChat sessions from Telegram, Feishu/Lark, QQBot, Discord, and WeChat iLink
    • Bind remote endpoints to sessions, switch models, answer pending interactions, stop runs, and open desktop sessions remotely
  • 🌐 Multiple Cloud LLM Provider Support: DeepSeek, OpenAI, Moonshot/Kimi, Grok, Gemini, Anthropic, and more
  • 🏠 Local Model Deployment Support:
    • Integrated Ollama with comprehensive management capabilities
    • Control and manage Ollama model downloads, deployments, and runs without command-line operations
  • 🚀 Rich and Easy-to-Use Chat Capabilities
    • Complete Markdown rendering with code block rendering based on industry-leading CodeMirror
    • Multi-window + multi-tab architecture supporting parallel multi-session operations across all dimensions, use large models like using a browser, non-blocking experience brings excellent efficiency
    • Supports Artifacts rendering for diverse result presentation
    • Messages support retry to generate multiple variations; conversations can be forked freely, ensuring there's always a suitable line of thought
    • Supports rendering images, Mermaid diagrams, and other multi-modal content; supports GPT-4o, Gemini, Grok text-to-image capabilities
    • Supports highlighting external information sources like search results within the content
  • 🔍 Robust Search Extension Capabilities
    • Built-in integration with leading search APIs like BoSearch and Brave Search, allowing the model to intelligently decide when to search
    • Supports mainstream search engines like Google, Bing, Baidu, and Sogou Official Accounts search by simulating user web browsing, enabling the LLM to read search engines like a human
    • Supports reading any search engine; simply configure a search assistant model to connect various search sources, whether internal networks, API-less engines, or vertical domain search engines, as information sources for the model
  • 🔧 Strong MCP (Model Context Protocol) Support
    • Full support for Resources / Prompts / Tools
    • Supports StreamableHTTP, SSE, Stdio, and other transports
    • Official Node.js toolchain for npx/node-style services, installed from Settings when needed
    • inMemory services for code execution, web information retrieval, file operations, and other common utilities
    • Clear tool-call display with parameter and return-data debugging
    • DeepLink support for one-click MCP service installation
  • 💻 Multi-Platform Support: Windows, macOS, Linux
  • 🎨 Beautiful and User-Friendly Interface, user-oriented design, meticulously themed light and dark modes
  • 🔗 Rich DeepLink Support: Initiate conversations via links for seamless integration with other applications, including one-click MCP service installation.
  • 🚑 Security-First Design: Chat data and configuration data have reserved encryption interfaces and code obfuscation capabilities
  • 🛡️ Privacy Protection: Supports screen projection hiding, network proxies, and other privacy protection methods to reduce the risk of information leakage
  • 💰 Business-Friendly:
    • Embraces open source, based on the Apache License 2.0 protocol, enterprise use without worry
    • Enterprise integration requires only minimal configuration code changes to use reserved encrypted obfuscation security capabilities
    • Clear code structure, both model providers and MCP services are highly decoupled, can be freely customized with minimal cost
    • Reasonable architecture, data interaction and UI behavior separation, fully utilizing Electron's capabilities, rejecting simple web wrappers, excellent performance

For more details on how to use these features, see the documentation index.

📼 Tape & Trace

DeepChat's session Tape follows the Tape.systems philosophy and keeps agent work recoverable and inspectable. Trace previews expose request sequences, provider/model metadata, Tape view manifests, included or excluded entries, and token budgets, making long-running agent sessions easier to debug and resume.

🧠 Skills Support

DeepChat Skills are designed to be compatible with the standard Agent Skills specification. A Skill can include task instructions, reference files, assets, and optional scripts, so DeepChat can act more like a domain specialist after it is enabled.

You can install Skills from folders, ZIP files, or URLs, and import/export them with Claude Code, Codex, Cursor, Windsurf, GitHub Copilot, Kiro, Antigravity, OpenCode, Goose, Kilo Code, and other compatible tools.

Built-in Skills cover generative art, code review, DeepChat settings, document collaboration, DOCX, frontend design, git commit messages, infographic syntax, MCP building, PDF, PPTX, Skill creation, Web Artifacts, and XLSX workflows.

Quick start:

  1. Open Settings → Skills
  2. Install or import a Skill
  3. Enable it in conversations that need that capability

🧩 ACP Integration (Agent Client Protocol)

DeepChat has built-in support for Agent Client Protocol (ACP), allowing you to integrate external agent runtimes into DeepChat with a native UI. Once enabled, ACP agents appear as first-class entries in the model selector, so you can use coding agents and task agents directly inside DeepChat.

Quick start:

  1. Open Settings → ACP Agents and enable ACP
  2. Enable a built-in ACP agent or add a custom ACP-compatible command
  3. Select the ACP agent in the model selector to start an agent session

To explore the ecosystem of compatible agents and clients, see: https://agentclientprotocol.com/overview/clients

📡 Remote Control

DeepChat can be controlled from messaging apps, so you can keep a session running even when you are away from the desktop. Configure remote channels under Settings → Remote.

Supported channels include Telegram, Feishu/Lark, QQBot, Discord, and WeChat iLink. Remote endpoints can bind to one DeepChat session, then create new sessions, list and switch recent sessions, stop generation, open the current session on desktop, answer pending questions or permission prompts, switch models, and check runtime status.

Common commands include /start, /help, /pair, /new, /sessions, /use, /stop, /open, /pending, /model, and /status.

🤖 Supported Model Providers

Deepseek Icon
Deepseek
Moonshot Icon
Moonshot
OpenAI Icon
OpenAI
Gemini Icon
Gemini
Ollama Icon
Ollama
Qiniu Icon
Qiniu
New API Icon
New API
Grok Icon
Grok
Zhipu Icon
Zhipu
PPIO Icon
PPIO
MiniMax Icon
MiniMax
Fireworks Icon
Fireworks
AIHubMix Icon
AIHubMix
Doubao Icon
Doubao
DashScope Icon
DashScope
Groq Icon
Groq
JieKou.AI Icon
JieKou.AI
ZenMux Icon
ZenMux
GitHub Models Icon
GitHub Models
LM Studio Icon
LM Studio
Hunyuan Icon
Hunyuan
302.AI Icon
302.AI
Together Icon
Together
Poe Icon
Poe
Vercel AI Gateway Icon
Vercel AI Gateway
OpenRouter Icon
OpenRouter
Azure OpenAI Icon
Azure OpenAI
TokenFlux Icon
TokenFlux
BurnCloud Icon
BurnCloud
OpenAI Responses Icon
OpenAI Responses
CherryIn Icon
CherryIn
ModelScope Icon
ModelScope
AWS Bedrock Icon
AWS Bedrock
Voice.ai Icon
Voice.ai
Vertex AI Icon
Vertex AI
GitHub Copilot Icon
GitHub Copilot
Xiaomi Icon
Xiaomi
o3.fan Icon
o3.fan
Novita AI Icon
Novita AI
Astraflow Icon
Astraflow
Anthropic Icon
Anthropic
SiliconFlow Icon
SiliconFlow
OrcaRouter Icon

Files in the repo

Repository payload47 top-level entries
  • .agents
  • .githooks
  • .github
  • .vscode
  • assets
  • build
  • docs
  • plugins
  • resources
  • runtime
  • scripts
  • src
  • test
  • .cursorignore
  • .editorconfig
  • .env.example
  • .gitignore
  • .oxfmtrc.json
  • .oxlintrc.json
  • AGENTS.md
  • CHANGELOG.md
  • CLAUDE.md
  • commitlint.config.js
  • components.json
  • CONTRIBUTING.md
  • CONTRIBUTING.zh.md
  • Dockerfile.build.linux
  • electron-builder.yml
  • electron.vite.config.ts
  • LICENSE
  • mise.toml
  • package.json
  • pnpm-lock.yaml
  • pnpm-workspace.yaml
  • README.jp.md
  • README.md
  • README.zh.md
  • tsconfig.app.json
  • tsconfig.json
  • tsconfig.node.json
  • vitest.config.memory-eval.ts
  • vitest.config.memory-native.ts
  • vitest.config.memory-perf.ts
  • vitest.config.memory-shared.ts
  • vitest.config.memory.ts
  • vitest.config.renderer.ts
  • vitest.config.ts

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More tools

JuliusBrussee/
caveman

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

105k
1 add
MemPalace/
mempalace

The best-benchmarked open-source AI memory system. And it's free.

59k
stablyai/
orca

Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

66k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

132k

Never stop coding. Free MIT AI gateway: one endpoint, 352 providers (150+ free), 1200+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550+ contributors

64k
headroomlabs-ai/
headroom

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

71k