DeepCodeHKUDS 官方版本地安装与配置完整方案本方案适用于Windows 10系统已成功验证环境Python 3.13虚拟环境智谱AI免费API (GLM-4-Flash)。第一阶段基础环境与代码拉取1.1 安装基础软件Python 3.8~3.11推荐 3.9实测 3.13 也可运行官网下载务必勾选Add Python to PATH。Git官网下载默认安装即可。1.2 解决网络问题并克隆仓库若执行git clone https://Github.com/HKUDS/DeepCode报错Recv failure: Connection was reset清除 Git 代理最常见原因bashgit config --global --unset http.proxy git config --global --unset https.proxy切换网络连接手机热点尝试。克隆成功标志项目根目录下存在README.md、requirements.txt、deepcode.py。第二阶段Python 虚拟环境与依赖安装2.1 进入项目目录并创建虚拟环境bashcd C:\Users\你的用户名\Desktop\DeepCode # 替换为你的实际路径 python -m venv venv2.2 激活虚拟环境Windowsbashvenv\Scripts\activate激活成功后命令行提示符前会出现(venv)标识。2.3 安装项目依赖使用清华镜像避免超时bashpip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple踩坑点安装过程中如果卡住不动光标闪烁但无日志按Ctrl C终止重新运行上述命令依赖已缓存会快速跳过。验证出现Successfully installed ...且提示符回到(venv)状态即算成功。2.4 安装项目本体注册deepcode命令这一步是让deepcode命令生效的关键不可跳过bashpip install -e .第三阶段配置 AI 模型免费方案 - 智谱AIDeepCode 默认调用 OpenAI但因国内网络和收费问题我们替换为智谱AI (GLM) 的免费模型。3.1 获取智谱AI API Key访问 智谱AI开放平台 注册账号。进入控制台 - API Keys创建并复制你的 API Key新用户赠送 2000万 token 额度GLM-4-Flash永久免费。3.2 创建配置文件在项目根目录DeepCode文件夹下复制deepcode_config.json.example并重命名为deepcode_config.json。将以下完整内容粘贴进去我已去除环境变量引用避免OPENAI_API_KEY报错json{ agents: { defaults: { provider: zhipu, model: glm-4-flash, maxTokens: 40000, temperature: 0.1 }, planning: { model: glm-4-flash }, implementation: { model: glm-4-flash } }, providers: { openai: { apiKey: }, zhipu: { apiKey: 你的智谱API Key粘贴在这里, apiBase: https://open.bigmodel.cn/api/paas/v4/ } }, tools: { mcpServers: { code-implementation: { type: stdio, command: python, args: [tools/code_implementation_server.py], env: {PYTHONPATH: .} }, command-executor: { type: stdio, command: python, args: [tools/command_executor.py], env: {PYTHONPATH: .} }, document-segmentation: { type: stdio, command: python, args: [tools/document_segmentation_server.py], env: {PYTHONPATH: .} }, filesystem: { type: stdio, command: npx, args: [-y, modelcontextprotocol/server-filesystem, ., ./deepcode_lab] } } }, workspace: { root: ./deepcode_lab, maxInputMb: 100 }, documentSegmentation: { enabled: true, sizeThresholdChars: 50000 } }注意务必把你的智谱API Key粘贴在这里替换成真实的 Key。第四阶段修复 PDF 解析依赖DeepCode 解析 PDF 需要加密库如不安装会报PyCryptodome is required。在虚拟环境中执行bashpip install pycryptodome -i https://pypi.tuna.tsinghua.edu.cn/simple第五阶段启动服务与验证5.1 启动 Web 界面在虚拟环境激活状态下bashdeepcode --classic5.2 浏览器访问打开浏览器访问http://localhost:8501。初次启动Streamlit 会询问邮箱直接按Enter跳过。保持终端运行关闭终端会断开服务。5.3 上传论文测试点击Paper2Code模块上传一篇 PDF 论文。观察终端日志看到HTTP/1.1 200 OK代表 API 调用成功。看到Computation sequence completed successfully或All processing stages completed successfully代表全流程跑通。最终结果与输出位置生成的代码保存在项目目录下的text.\deepcode_lab\tasks\paper_xxxxxxx\generate_code\其中initial_plan.txt是 AI 生成的代码规划蓝图generate_code文件夹内是生成的源码文件。常见问题快速索引问题现象解决方案git clone连接被重置清除代理配置或切换手机热点deepcode 不是内部或外部命令执行pip install -e .安装项目本体PyCryptodome is required执行pip install pycryptodomeOPENAI_API_KEY环境变量报错配置文件中将openai.apiKey设为空字符串Could not match a provider for model检查deepcode_config.json中provider和apiKey是否正确生成代码只有一个README.md免费轻量模型能力有限可尝试分段生成或改用更强模型这套方案已经过完整验证能够让你在零费用、仅需邮箱注册的情况下完整运行 DeepCode 的论文转代码核心功能。祝使用顺利本回答由 AI 生成内容仅供参考请仔细甄别
deepcode安装
DeepCodeHKUDS 官方版本地安装与配置完整方案本方案适用于Windows 10系统已成功验证环境Python 3.13虚拟环境智谱AI免费API (GLM-4-Flash)。第一阶段基础环境与代码拉取1.1 安装基础软件Python 3.8~3.11推荐 3.9实测 3.13 也可运行官网下载务必勾选Add Python to PATH。Git官网下载默认安装即可。1.2 解决网络问题并克隆仓库若执行git clone https://Github.com/HKUDS/DeepCode报错Recv failure: Connection was reset清除 Git 代理最常见原因bashgit config --global --unset http.proxy git config --global --unset https.proxy切换网络连接手机热点尝试。克隆成功标志项目根目录下存在README.md、requirements.txt、deepcode.py。第二阶段Python 虚拟环境与依赖安装2.1 进入项目目录并创建虚拟环境bashcd C:\Users\你的用户名\Desktop\DeepCode # 替换为你的实际路径 python -m venv venv2.2 激活虚拟环境Windowsbashvenv\Scripts\activate激活成功后命令行提示符前会出现(venv)标识。2.3 安装项目依赖使用清华镜像避免超时bashpip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple踩坑点安装过程中如果卡住不动光标闪烁但无日志按Ctrl C终止重新运行上述命令依赖已缓存会快速跳过。验证出现Successfully installed ...且提示符回到(venv)状态即算成功。2.4 安装项目本体注册deepcode命令这一步是让deepcode命令生效的关键不可跳过bashpip install -e .第三阶段配置 AI 模型免费方案 - 智谱AIDeepCode 默认调用 OpenAI但因国内网络和收费问题我们替换为智谱AI (GLM) 的免费模型。3.1 获取智谱AI API Key访问 智谱AI开放平台 注册账号。进入控制台 - API Keys创建并复制你的 API Key新用户赠送 2000万 token 额度GLM-4-Flash永久免费。3.2 创建配置文件在项目根目录DeepCode文件夹下复制deepcode_config.json.example并重命名为deepcode_config.json。将以下完整内容粘贴进去我已去除环境变量引用避免OPENAI_API_KEY报错json{ agents: { defaults: { provider: zhipu, model: glm-4-flash, maxTokens: 40000, temperature: 0.1 }, planning: { model: glm-4-flash }, implementation: { model: glm-4-flash } }, providers: { openai: { apiKey: }, zhipu: { apiKey: 你的智谱API Key粘贴在这里, apiBase: https://open.bigmodel.cn/api/paas/v4/ } }, tools: { mcpServers: { code-implementation: { type: stdio, command: python, args: [tools/code_implementation_server.py], env: {PYTHONPATH: .} }, command-executor: { type: stdio, command: python, args: [tools/command_executor.py], env: {PYTHONPATH: .} }, document-segmentation: { type: stdio, command: python, args: [tools/document_segmentation_server.py], env: {PYTHONPATH: .} }, filesystem: { type: stdio, command: npx, args: [-y, modelcontextprotocol/server-filesystem, ., ./deepcode_lab] } } }, workspace: { root: ./deepcode_lab, maxInputMb: 100 }, documentSegmentation: { enabled: true, sizeThresholdChars: 50000 } }注意务必把你的智谱API Key粘贴在这里替换成真实的 Key。第四阶段修复 PDF 解析依赖DeepCode 解析 PDF 需要加密库如不安装会报PyCryptodome is required。在虚拟环境中执行bashpip install pycryptodome -i https://pypi.tuna.tsinghua.edu.cn/simple第五阶段启动服务与验证5.1 启动 Web 界面在虚拟环境激活状态下bashdeepcode --classic5.2 浏览器访问打开浏览器访问http://localhost:8501。初次启动Streamlit 会询问邮箱直接按Enter跳过。保持终端运行关闭终端会断开服务。5.3 上传论文测试点击Paper2Code模块上传一篇 PDF 论文。观察终端日志看到HTTP/1.1 200 OK代表 API 调用成功。看到Computation sequence completed successfully或All processing stages completed successfully代表全流程跑通。最终结果与输出位置生成的代码保存在项目目录下的text.\deepcode_lab\tasks\paper_xxxxxxx\generate_code\其中initial_plan.txt是 AI 生成的代码规划蓝图generate_code文件夹内是生成的源码文件。常见问题快速索引问题现象解决方案git clone连接被重置清除代理配置或切换手机热点deepcode 不是内部或外部命令执行pip install -e .安装项目本体PyCryptodome is required执行pip install pycryptodomeOPENAI_API_KEY环境变量报错配置文件中将openai.apiKey设为空字符串Could not match a provider for model检查deepcode_config.json中provider和apiKey是否正确生成代码只有一个README.md免费轻量模型能力有限可尝试分段生成或改用更强模型这套方案已经过完整验证能够让你在零费用、仅需邮箱注册的情况下完整运行 DeepCode 的论文转代码核心功能。祝使用顺利本回答由 AI 生成内容仅供参考请仔细甄别
