Devika：开源 AI 软件工程师 Agent，自然语言拆解任务并自动写代码｜部署与使用全指南
仓库：https://github.com/stitionai/devika 许可证：MIT 语言：Python ≥3.10 <3.12 / Node.js 18+ / Bun 默认端口：后端 未显式指定（启动后打印）、前端 3001 ⚠️ 官方提示：项目仍处于早期实验阶段，README 顶部已提示下一代重构版本 Opcode（opcode.sh）即将发布。
1. 项目简介
Devika 是一个对标 Cognition AI 公司 Devin 的开源 AI 软件工程师 Agent：接收高层自然语言指令后，自动拆解为子任务、做上下文关键词检索、浏览网页收集资料，并在多门编程语言中生成代码。官方定位是"用极少的人工指导承担复杂编码任务的 AI 结对程序员"。
⚠️ README 明确写道："本项目目前处于非常早期的开发 / 实验阶段，仍有大量未实现 / 已损坏的功能"，并提示下一代重构版本 Opcode 即将发布。生产环境请谨慎评估。
1.1 核心信息一览
| 项目 | 说明 |
|---|---|
| 名称 | Devika |
| 仓库 | stitionai/devika |
| 定位 | 开源 AI 软件工程师 Agent，模仿 Devin 做任务拆解、研究与代码生成 |
| 许可证 | MIT |
| 语言 / 框架 | Python ≥3.10 且 <3.12、Node.js ≥18、Bun |
| 部署方式 | 源码运行（后端 + 前端分开启动） |
| 默认端口 | 前端 Web 界面 http://127.0.0.1:3001 |
| 系统入口 | 浏览器打开 http://127.0.0.1:3001 |
1.2 适用场景
- 想体验"给一个高层目标、让 AI 自动写代码"的 Agent 工作流。
- 研究多 Agent 规划、推理、网页浏览、代码生成的开源实现。
- 在本地或服务器上接 Claude 3 / GPT-4 / Gemini / Mistral / Groq / Ollama 本地模型做实验。
1.3 能力边界（官方口径）
- 官方自述为"very early development / experimental stage"，存在未实现 / 损坏功能。
- 性能最佳模型为 Claude 3 系列；其他模型为兼容支持。
- 需要自备各 LLM 与搜索 API Key，不内置模型。
- 下一代重构版本为 Opcode，本仓库后续演进节奏请以官方 README 为准。
2. 功能特性
- 🤖 多模型支持：Claude 3、GPT-4、Gemini、Mistral、Groq，以及通过 Ollama 接入的本地 LLM。
- 🧠 高级 AI 规划与推理能力，把高层目标拆成可执行步骤。
- 🔍 上下文关键词提取，聚焦研究方向。
- 🌐 基于 Playwright 的网页浏览与信息收集。
- 💻 多编程语言代码生成。
- 📊 动态 Agent 状态追踪与可视化。
- 💬 自然语言聊天式交互界面。
- 📂 项目化组织与管理，按项目隔离上下文。
- 🔌 可扩展架构，便于新增模型与搜索集成。
3. 官方界面预览
图为官方 README 中的 Devika 界面截图，展示项目视图、聊天交互与 Agent 状态。
4. 官方跳转链接汇总
- 仓库：https://github.com/stitionai/devika
- 下一代重构版本：https://opcode.sh/
- Issues：https://github.com/stitionai/devika/issues
- Discussions：https://github.com/stitionai/devika/discussions
- Discord：https://discord.gg/CYRp43878y
- Ollama 配置指南：docs/Installation/ollama.md
- 搜索引擎配置：docs/Installation/search_engine.md
5. 前置要求与服务器配置
5.1 软件前提
- Python ≥ 3.10 且 < 3.12（注意不支持 3.12 及以上）。
- Node.js ≥ 18。
- Bun（前端运行时，安装见 bun.sh）。
- uv（Python 包管理器，安装见 astral-sh/uv）。
- Playwright（用于网页浏览能力，安装时会拉取浏览器）。
- 可选：Ollama（仅当要使用本地模型时）。
- 至少一个 LLM API Key 与一个搜索 API Key（在 UI 设置页填入）。
5.2 硬件与系统建议
- 项目本身不跑大模型，普通 1C2G 云主机即可跑后端 + 前端。
- 若走 Ollama 本地模型，则按所选模型准备 GPU 与显存。
5.3 端口分配
| 端口 | 服务 | 说明 |
|---|---|---|
| 3001 | 前端 Web UI（Bun） | 浏览器访问入口 |
| 后端 | 由 python devika.py 启动后打印 |
未在 README 中硬编码，默认随日志输出 |
5.4 磁盘与模型说明
- 项目代码本体较小；Playwright 浏览器会占用几百 MB 磁盘。
- 模型权重不下载到仓库；走 Ollama 时由 Ollama 自行管理。
6. 方式一：Docker / Compose 部署
⚠️ 官方 README 未提供开箱即用的
docker-compose.yml或 Docker Hub 镜像。本节以官方给出的源码方式为准；如需容器化，可自行基于requirements.txt+ui/目录写 Dockerfile，命令与下文"源码运行"一致。
7. 方式二：源码 / 本地运行（官方唯一推荐路径）
7.1 克隆仓库
git clone https://github.com/stitionai/devika.git
cd devika7.2 创建 Python 虚拟环境并安装依赖
# 创建虚拟环境
uv venv
# macOS / Linux 激活
source .venv/bin/activate
# Windows
# .venv\Scripts\activate
# 安装依赖
uv pip install -r requirements.txt7.3 安装 Playwright 浏览器（网页浏览能力）
playwright install --with-deps7.4 启动后端
python devika.py启动成功时日志会打印：
root: INFO : Devika is up and running!7.5 启动前端（新终端）
cd ui/
bun install
bun run start7.6 访问 Web 界面
浏览器打开 http://127.0.0.1:3001。
7.7 首次使用流程
- 打开 Devika Web 界面。
- 点击 "select project" → "new project" 新建项目。
- 为项目选择搜索引擎与模型配置。
- 在聊天框中输入高层目标 / 任务描述。
- Devika 会拆解任务、检索资料、生成代码，进度在界面上可视化。
- 任务完成后审阅生成的代码与项目文件，可继续追加指令迭代。
8. 配置项说明
首次启动时 Devika 会在仓库根目录自动生成
config.toml，也可在 UI 设置页里配置。下表整理自官方
README。
8.1 API Key 配置
| 字段 | 用途 |
|---|---|
BING |
Bing Search API Key，用于网页搜索 |
GOOGLE_SEARCH |
Google Search API Key |
GOOGLE_SEARCH_ENGINE_ID |
自定义 Google 搜索引擎 ID |
OPENAI |
OpenAI API Key（GPT 系列） |
GEMINI |
Google Gemini API Key |
CLAUDE |
Anthropic Claude API Key |
MISTRAL |
Mistral API Key |
GROQ |
Groq API Key |
NETLIFY |
Netlify API Key（用于部署 Web 项目） |
8.2 API 端点配置
| 字段 | 用途 |
|---|---|
BING |
Bing API 端点 |
GOOGLE |
Google API 端点 |
OLLAMA |
Ollama 本地服务端点（默认 http://localhost:11434） |
OPENAI |
OpenAI API 端点 |
官方提醒：API Key 必须妥善保管，不要公开分享。
9. 常用运维命令
# 后端日志：直接看运行 python devika.py 的终端输出
# 前端日志：直接看运行 bun run start 的终端输出
# 重启后端
# 在后端终端 Ctrl+C 后重新执行
python devika.py
# 重启前端
# 在前端终端 Ctrl+C 后重新执行
cd ui && bun run start
# 更新代码
git pull
uv pip install -r requirements.txt
cd ui && bun install
# 查看端口占用（确认 3001 未被占用）
lsof -i :3001备份：config.toml 与项目目录（生成的代码与上下文）。
10. 常见故障排查
- Python 版本报错：Devika 要求 Python ≥ 3.10 且 <
3.12；3.12 及以上会依赖不兼容。用
python --version确认。 bun: command not found：先安装 Bun（见 bun.sh），再重试 `bun install && bun run start`。- 前端 3001 打不开：确认前端进程仍在运行；检查 3001 是否被其他程序占用。
- 网页浏览功能报错：先执行
playwright install --with-deps拉取浏览器与系统依赖。 - 模型调用失败：进入 UI 设置页，确认对应 API Key 已填入；本地模型确认 Ollama 已启动且端口正确。
- 搜索无结果：Bing 或 Google Search API Key 与 Search Engine ID 未配对正确，按 search_engine.md 重新核对。
- 项目仍处早期实验阶段：README 明确存在未实现 / 损坏功能，遇到问题先去 Issues 搜索是否已有人反馈；下一代重构版本 Opcode 可能会改变部署形态。
11. 风险与合规说明
- 许可证：Devika 采用 MIT 许可证，可商用、可修改、可再分发，需保留版权与许可声明。
- 实验性定位：官方明确声明项目处于早期实验阶段，"存在大量未实现 / 已损坏功能"，不建议直接用于生产。
- 下一代重构版本：README 顶部已提示 Opcode（opcode.sh）为 Devika 的第二代重构，新项目可能在未来迁移到该版本，部署前请先查看官方 README 最新状态。
- API Key 成本：Claude 3 / GPT-4 / Gemini / Mistral / Groq / Bing / Google Search / Netlify 均为第三方付费服务，费用与额度由对应平台计费，建议在各控制台设置用量告警。
- 数据隐私：任务描述、代码、网页抓取内容会发送给所配置的 LLM 与搜索 API；涉密任务请走 Ollama 等本地模型，并确认第三方 API 不会留存训练数据。
- 安全暴露：默认仅监听
127.0.0.1:3001；如需远程访问，请放在反向代理之后并加鉴权，不要直接暴露公网。