DeepCode README

The project's README from github.com/HKUDS/DeepCode. As one markdown file: README.md.

DeepCode Logo
    ██████╗ ███████╗███████╗██████╗  ██████╗ ██████╗ ██████╗ ███████╗
    ██╔══██╗██╔════╝██╔════╝██╔══██╗██╔════╝██╔═══██╗██╔══██╗██╔════╝
    ██║  ██║█████╗  █████╗  ██████╔╝██║     ██║   ██║██║  ██║█████╗
    ██║  ██║██╔══╝  ██╔══╝  ██╔═══╝ ██║     ██║   ██║██║  ██║██╔══╝
    ██████╔╝███████╗███████╗██║     ╚██████╗╚██████╔╝██████╔╝███████╗
    ╚═════╝ ╚══════╝╚══════╝╚═╝      ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝
HKUDS%2FDeepCode | Trendshift HKUDS%2FDeepCode | Trendshift

DeepCode Logo DeepCode: Open Agentic Coding

Advancing Code Generation with Multi-Agent Systems

Website — hkuds.github.io/DeepCode

Feishu WeChat

English 中文

🖥️ Interface Showcase

🖥️ DeepCode Desktop

DeepCode Desktop coding agent demo

Work with DeepCode in a visual workspace for Sessions, goals, tool activity, code changes, and verification.

DeepCode provides TUI, Desktop, and Web clients over one shared local service. They share Projects, Session history, models, Skills, permissions, Goals, and Automations. Use deepcode, deepcode desktop, or deepcode web; see Quick start for installation and your first task.


🎬 Introduction Video

DeepCode Introduction Video

🎯 Watch our complete introduction - See how DeepCode transforms research papers and natural language into production-ready code

Watch Video


"Where AI Agents Transform Ideas into Production-Ready Code"


📑 Table of Contents

A verified task completed with DeepCode

News

2026-09-09 · TUI, Desktop, and Web share one local background service

Start with the updated Quick start and first coding task tutorial. (#212)

2026-09-06 · DeepCode v2.2.0: Session context-window caps, compaction that leaves a memory, and a fully localized Desktop

2026-09-03 · Desktop catalog race, an honest command screen, GLM-5.2, and two dependency bumps

2026-08-28 · Community fixes: plugin credential warnings and a wider zh-CN Desktop

2026-08-25 · Command executors close two bypasses

2026-08-23 · Five repaired contributions land together

2026-08-19 · Sessions that survive resume, compaction, and a second window

2026-08-18 · The runtime learns dsh's context discipline, and the TUI gets a face

2026-08-17 · Fixes from a review pass over the new settings and TUI work

2026-08-16 · The TUI answers every bare command with a selector

2026-08-15 · Settings grow up: a dsh-style dialog, declared models, and a safer config

DeepCode (HKUDS/DeepCode)

Searching Database…

16.7K ·GitHub
What is this?An open agentic coding platform from HKUDS: a multi-agent harness that turns natural language and even research papers into production-ready code, working directly in your repository.
Is it a terminal tool, or is there a graphical app?All three: a TUI ('deepcode'), a native Desktop app, and a browser workbench ('deepcode web'), all connected to one shared local background service that syncs sessions, models, skills and permissions.
How do I get it running?Install the runtime, configure a model connection, then launch your client: 'deepcode' for the TUI, 'deepcode desktop', or 'deepcode web'. The Quick start walks you through your first task.
Which AI models can I plug in?Any — save cloud or local model connections and they work in all three clients. You can browse each catalog and test streaming and tool calls before trusting a custom server; OpenRouter alone lists near a thousand models.
What happens if I close the app while it's mid-task?Work keeps running in the shared background service; reconnect from any client to follow the conversation and answer approvals. The catch: the computer must stay awake, and pending approvals still need your response.
Does my code stay on my machine?Yes — the three clients talk to one local service on your machine, and the Web client needs no DeepCode account. Code goes only to whichever model provider you connect yourself.
What can it actually do inside my repository?It runs goal-driven loops: plans, edits and verifies changes with evidence-driven completion, keeps durable session history across resumes and compaction, reuses Skills, asks for explicit permissions, and runs parallel agents that don't collide on files.
What is Paper2Code?Its flagship feature: feed it a research paper and it produces a working implementation, turning published ideas into production-ready code. The README documents the original architecture and the research results behind it.
Can I run it headless, say from scripts or CI?Yes — there is a headless automation mode: 'deepcode exec' and goal runs execute tasks programmatically, so you can wire DeepCode into pipelines instead of typing in the TUI.
What happens when a long task outgrows the model's context window?You can cap a session's window (e.g. /context 64k in the TUI). Compaction summarizes older history while keeping the recent tail verbatim, and deposits a summary into workspace memory so important context survives.
Creator
HKUDS
Size
86.3 MB
Stars
16.7K
Age
1y
Commits · 90 Days