deepcode — Agent Guide

No conflict-matrix pairs for this tool yet.

# DeepCode — Agent Guide

name: deepcode ｜ version_range: 2.1.0~2.1.0 ｜ generated: 2026-08-27

title_en: DeepCode - Open-Source Agentic Coding Framework ｜ desc_en: Multi-agent code generation with persistent sessions and goals.

Preflight

note: Requires Python >= 3.12.

python3 --version

预期输出: see command output

Install

note: Method A (pip) verified in this environment; Method B (source) not tested.

Method A: pip

note: Use the Tsinghua mirror branch in mainland China; retry or switch branch when PyPI official read times out.

pip install deepcode-hku
deepcode --version

预期输出: DeepCode 2.1.0

note: Mainland China acceleration branch:

pip install deepcode-hku --index-url https://pypi.tuna.tsinghua.edu.cn/simple
deepcode --version

预期输出: DeepCode 2.1.0

Method B: source install

note: Not tested; commands from upstream README.

git clone https://github.com/HKUDS/DeepCode.git
cd DeepCode
pip install -e .
deepcode --version

预期输出: DeepCode 2.1.0

Operations

View command list

deepcode --help

预期输出: starts with Usage:, includes init/test/mcp/skill/plugin/provider/session/exec/loop/schedule/automation

Initialize config

note: Required first-use step; idempotent; verified in this environment.

deepcode init

预期输出: Initialized <home>/.deepcode/deepcode_config.json (prompts --force when already exists)

Configure LLM provider

note: Prerequisite for agent runs; command from --help, not tested in this environment — no API key.

deepcode provider set openai --api-key <你的 key>

预期输出: provider configured success message (local provider needs no cloud API key)

Minimal coding task

note: Requires provider configured first; command from --help, not tested in this environment.

deepcode exec "写一个 python 的 hello world 并运行" -w .

预期输出: headless task run progress and final result (multi-agent coding system executes)

Uninstall

note: pip uninstall; ~/.deepcode config directory is user data, not auto-deleted.

pip uninstall -y deepcode-hku || true
command -v deepcode >/dev/null 2>&1 && echo "deepcode 仍存在" || echo "deepcode removed: OK"

预期输出: deepcode removed: OK

Facts

writes: ~/.deepcode/ (config, user data kept on uninstall) ｜ runtime: Python >= 3.12, pip ｜ notes: no background process; coexistable with omc/agt in CLI mode (实测记录（本地留存）); provider API key required for exec/loop

Source: deepcode · validated 2026-08-28 · v2.1.0~2.1.0

← Agent index