项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 11181
技术标签
使用教程
环境要求
- Python 环境(用 uv 管理虚拟环境与依赖)
- uv 包管理器
- pnpm(make build-dashboard 会执行 pnpm install 并构建面板)
- 一个 GitHub App 和一个 Slack App(本地机器上创建并配置)
- 需要公网 webhook 地址时可使用免费 ngrok 账号(含静态域名)
安装与启动步骤
-
1克隆仓库
把 open-swe 源码拉到本地并进入项目目录,后续所有命令都在此目录执行。
git clone https://github.com/langchain-ai/open-swe.git cd open-swe -
2创建虚拟环境
用 uv 创建 .venv 并激活,Windows 用户请改用 .venv\Scripts\activate。
uv venv source .venv/bin/activate -
3安装依赖
同步安装项目全部依赖(包含 extras),首次执行耗时较长。
uv sync --all-extras -
4构建前端面板
执行 dashboard 构建,内部会先 pnpm install 再用 Vite 打包前端资源。
make build-dashboard -
5配置 .env
为你的机器创建 GitHub App 与 Slack App,并按 development guide 填写 .env,否则无法登录和接收任务。
-
6启动服务
make dev 会在 http://localhost:2024 同时提供 API 与网页面板。
make dev -
7启动 webhook 隧道
GitHub/Slack 需要公网地址,用免费 ngrok 静态域名暴露,仅转发 /webhooks/*。
make tunnel NGROK_DOMAIN=<name>.ngrok-free.dev -
8可选:前端热重载
做界面开发时用 make dev-ui,Vite 加后端代理,同一地址支持热更新。
make dev-ui
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env | 是 | 存放 GitHub App、Slack App、模型供应商等凭据,具体变量见 docs/DEVELOPMENT.md | 按 docs/DEVELOPMENT.md 填写各项密钥 |
如何确认成功
浏览器打开 http://localhost:2024,能看到面板并成功登录即启动成功。
常见问题
Q:为什么本地还要用 ngrok?
A:GitHub 和 Slack 只向公网 webhook 地址投递事件,本地需用免费 ngrok 静态域名做隧道转发给开发服务器。
Q:make tunnel 只暴露 /webhooks/* 是为什么?
A:开发服务器的 LangGraph API 没有身份认证,因此隧道只转发 webhook 路径,避免把整个服务暴露到公网。
Q:生产环境自托管要怎么做?
A:生产自托管使用独立的 LangGraph Agent Server(而非 make dev),并且需要该 Server 的 license key。
Q:能不用本地开发方式、直接给团队部署吗?
A:可以,README 指向 docs/INSTALLATION.md,支持 LangGraph Platform 或 Docker 部署,并配置 GitHub/Slack 应用与模型供应商。
注意事项
- 本地 make dev 启动的 LangGraph API 无鉴权,不要直接把非 /webhooks/* 路径暴露到公网。
- 必须先创建 GitHub App 与 Slack App 并填好 .env,否则无法登录使用。
- 一次部署即可用同一个 URL 同时提供 API、webhooks 和 dashboard。
- 更多定制(模型、沙箱、工具、提示词、触发器)见 docs/CUSTOMIZATION.md。
核心亮点
- 异步架构支持并发处理多个编码任务,吞吐量高
- 支持自定义模型后端,灵活接入不同 LLM
- 自动生成补丁并运行测试,形成闭环验证
不足之处
- 文档/社区待观察
- 异步调试复杂度较高,新手上手有门槛
适用场景
- 自动化代码修复与补丁生成
- CI/CD 流水线中的智能代码审查
- 大规模代码库的批量重构
替代项目
OpenHands、Aider、SWE-agent
上一篇:hexstrike-ai
下一篇:UFO
同类项目推荐
product-architect
开源
31个AI智能体帮你从零到IPO,产品开发全自动
The most comprehensive open-source product development system. 80 AI agents. 36 fram···
parlant
开源
让 AI 代理按规矩办事,客户交互更可靠
Parlant is an open platform for building customer-facing chat agents with AI. Descri···
happier
开源
一个客户端,统管所有 AI 编程代理,跨端加密同步
Web, Desktop & Mobile client and orchestrator for Codex, Claude Code, OpenCode, Pi, ···
LLM-MM-Agent
开源
给一道建模题,智能体自动出模型、写代码、算结果
[NeurIPS2025] MM-Agent: LLM as Agents for Real-world Mathematical Modeling Problem
kelos
开源
用 Kubernetes 编排 AI 编码代理,让自动化开发更可控。
Kelos - The Kubernetes-native framework for orchestrating autonomous AI coding agent···
LocalAGI
开源
本地跑自主AI,隐私安全不花钱
LocalAGI:Locally run AGI powered by LLaMA, ChatGLM and more. | 基于 ChatGLM, LLaMA···
rome
开源
让智能体递归调用自己,任务越跑越强
A compounding agent OS for recursive agents. Also an open source alternative to Grok···
awesome-ai-pulse-georgia
开源
一份清单,搞定AI智能体工具选型
A curated collection of cutting-edge AI agent frameworks, developer tools, and autom···
OpenCode-goal-plugin
开源
给 OpenCode 装上持久目标管理,让 AI 干活有始有终
Session-scoped /goal workflow for OpenCode with fail-closed persistence and an indep···
