项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-16 · 当前星标 ★ 1125
使用教程
环境要求
- Node 24.22.3 或更新版本,仅支持 macOS 或 Linux
- 本机可访问 npm 源,用于拉取 @parcha/agentrun 包
- 首次使用需 ChatGPT 账号登录,或准备一个模型 API Key(如 OPENROUTER_API_KEY)
- 如需给智能体提供 shell,本机需运行 Docker(首次会构建镜像,耗时几分钟)
安装与启动步骤
-
1启动本地服务
在 macOS 或 Linux 终端执行,自动启动服务与一个 runner,控制台在浏览器打开。
npx @parcha/agentrun -
2设置控制台密码
首次打开控制台需设置密码,之后用于登录和执行审批。
-
3接入模型
在 Settings → Model keys 点 Continue with ChatGPT 登录,或直接填入模型 Key。
-
4运行首个智能体
打开 Templates 应用 KYB due diligence,输入公司名与网址启动运行,完成后看 Report。
-
5命令行发起运行
用 CLI 发起带 1 美元上限的运行并等待;退出码 8 表示它在等你确认区域。
npx @parcha/agentrun runs start notes --max-cost-usd 1 --wait --body '{"input": {"content": "Ask me which region to cover, then write region.md about it."}}' > out.json -
6准备自建部署目录
克隆仓库并进入 deploy 目录,生成封存密钥写入 .env,同时收紧文件权限。
git clone https://github.com/Parcha-ai/agentrun && cd agentrun/deploy printf 'AGENTRUN_SEAL_KEY=%s\n' "$(openssl rand -base64 32)" > .env && chmod 600 .env -
7启动服务与运行器
构建并后台启动一个服务与两个 runner,日志里能看到控制台链接和首次设置码。
docker compose up -d --build docker compose logs server
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
AGENTRUN_SEAL_KEY | 是 | 封存密钥,服务与所有 runner 必须使用同一个值,部署前写入 .env。 | AGENTRUN_SEAL_KEY=c2VhbC1rZXktZXhhbXBsZS12YWx1ZQ== |
OPENROUTER_API_KEY | 否 | 一个 Key 即可为所有 harness 提供模型,建议同时设置额度上限。 | OPENROUTER_API_KEY=sk-or-v1-xxxxxxxx |
OPENAI_API_KEY | 否 | 可驱动 pi、Codex 和 OpenCode 三类 harness。 | OPENAI_API_KEY=sk-xxxxxxxx |
AGENTRUN_TOKEN | 否 | Render 部署时自动生成,首次打开站点时粘贴用于设置控制台密码。 | AGENTRUN_TOKEN=xxxxxxxx |
AGENTRUN_STORE_URL | 否 | 设为 postgres:// 地址后,服务与所有 runner 共享存储。 | postgres://user:pass@localhost:5432/agentrun |
如何确认成功
浏览器打开日志中的控制台链接(默认 7340 端口),能设置密码并进入 Templates 页即启动成功。
常见问题
Q:7340 端口被占用怎么办?
A:服务会自动顺延到下一个空闲端口,以终端或 docker compose logs server 输出的链接为准。
Q:没有模型 API Key 能跑吗?
A:可以。在控制台点 Continue with ChatGPT 登录,Codex 和 pi 智能体直接用你的 ChatGPT 套餐,无需填写 Key。
Q:服务器上 ChatGPT 登录页打不开?
A:在非本机的服务器上,登录标签页最后会停在无法加载的页面,把它的完整地址复制到控制台里继续即可。
Q:智能体提示没有 shell?
A:需本机运行 Docker,新智能体会获得带 shell 的 Docker 沙箱;首次使用会构建镜像,控制台会提示就绪。
Q:中途重启会丢掉正在跑的任务吗?
A:不会。运行状态统一存在存储中,重启后续跑;多 runner 时其余 runner 在 30 秒租约到期后接管。
注意事项
- 仅支持 macOS 或 Linux,Node 版本需 24.22.3 及以上。
- 本地运行的数据默认放在 ~/.agentrun 目录。
- compose 部署只把端口发布到本机回环地址,对外开放前需自行在前面加 TLS 反向代理。
- ChatGPT 登录仅限运行该服务器的本人使用,不要共享给他人。
核心亮点
- 以叠加层方式增强现有智能体框架,接入成本低,不必重写业务逻辑
- 持久化执行让长任务在中断或重启后可恢复,提升容错性
- 自我改进机制随运行次数积累经验,有助于降低重复推理与 token 开销
不足之处
- 项目星标约 1125,处于成长早期,生态与第三方集成尚不丰富
- 文档与社区规模相对有限,遇到复杂问题时可参考的实践案例较少
适用场景
- 长流程自动化任务需要断点续跑与失败恢复
- 多智能体实例统一调度与运行状态观测
- 希望降低智能体重复推理成本、提升单次运行效率的团队
替代项目
LangGraph、AutoGen、CrewAI
下一篇:没有了!
同类项目推荐
database-skills
开源
让 AI 智能体安全读写数据库,不用自己造轮子
Skills for AI agents working with databases
hackingBuddyGPT
开源
用LLM写50行代码,自动搞定渗透测试
Helping Ethical Hackers use LLMs in 50 Lines of Code or less..
Resource2Skill
开源
把人类教程自动变成智能体可调用的技能
A general framework for distilling human-created multimodal resources into reusable,···
mcp-tts
开源
给 AI 接上语音嘴,一行配置接入多种 TTS 服务
MCP Server for Text to Speech
postman-mcp-server
开源
让 AI 助手直接调用你的 Postman 集合,自动生成和测试 API 代码
Postman MCP Server — connect AI agents (Claude Code, Cursor, VS Code Copilot, Gemin···
skills
开源
让 AI 智能体直接生成数字人视频,一句话搞定视频制作
HeyGen AI agent skills — avatar creation and video production via the v3 Video Agen···
claude-skills
开源
让 Claude 掌握网站全流程技能,从建站到优化一步到位
Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, con···
EvoMaster
开源
让科研智能体边跑边进化,把实验迭代自动化
EvoMaster: A Foundational Evolving Agent Framework for Agentic Science at Scale.
Hermes-CN-Desktop
开源
在 Windows 桌面上,用轻量 Tauri 壳跑起隔离的 Hermes 智能体。
Hermes Agent CN desktop app, Windows-First, built with Tauri, Typescript and Rust. I···
