agentrun

给智能体加持久执行与自我改进,跑得更稳更省 token

开源 🏷️定价信息待确认 ⏳ 访问状态待核验 智能体 🍴 复刻 88 🐛 待处理 57 👀 关注 1
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1125
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

agentrun 项目界面预览图
图片来源:项目官网

项目数据

分类智能体
开发团队Parcha-ai
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⏳ 访问状态待核验
是否开源是
开源协议Apache-2.0
主要语言JavaScript
GitHub 星标★ 1125
上线时间2026-09-23 00:00:00
代码更新2026-11-15
仓库体积83.7 MB
本站数据更新2026-11-16
维护状态活跃
收录时间2026-11-16
浏览次数0

项目介绍

AgentRun 是一个面向智能体运行时的开源增强平台,可在现有智能体框架之上叠加自我改进、持久化执行与控制面能力。它解决的核心问题是:智能体在长任务中容易中断、失败后难以恢复、重复推理浪费 token,且缺乏统一调度与观测入口。项目提供持久化执行,使任务在异常或重启后可续跑;通过自我改进机制让智能体从每次运行中沉淀经验,逐步减少无效推理与 token 消耗;控制面则用于统一管理智能体实例、运行状态与执行流程。技术栈为 JavaScript,便于在前端与 Node 生态中集成。适合已有智能体框架、希望提升稳定性与成本效率的团队,作为运行时增强层接入而非重写业务逻辑。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-16 · 当前星标 ★ 1125

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 7 步

环境要求

  • Node 24.22.3 或更新版本,仅支持 macOS 或 Linux
  • 本机可访问 npm 源,用于拉取 @parcha/agentrun 包
  • 首次使用需 ChatGPT 账号登录,或准备一个模型 API Key(如 OPENROUTER_API_KEY)
  • 如需给智能体提供 shell,本机需运行 Docker(首次会构建镜像,耗时几分钟)

安装与启动步骤

  1. 1启动本地服务

    在 macOS 或 Linux 终端执行,自动启动服务与一个 runner,控制台在浏览器打开。

    npx @parcha/agentrun
  2. 2设置控制台密码

    首次打开控制台需设置密码,之后用于登录和执行审批。

  3. 3接入模型

    在 Settings → Model keys 点 Continue with ChatGPT 登录,或直接填入模型 Key。

  4. 4运行首个智能体

    打开 Templates 应用 KYB due diligence,输入公司名与网址启动运行,完成后看 Report。

  5. 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. 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. 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

上一篇:agentscope-samples

下一篇:没有了!

同类项目推荐

database-skills 开源

让 AI 智能体安全读写数据库,不用自己造轮子

Skills for AI agents working with databases

★ 740 2026-09-22
hackingBuddyGPT 开源

用LLM写50行代码,自动搞定渗透测试

Helping Ethical Hackers use LLMs in 50 Lines of Code or less..

★ 1328 2026-08-09
Resource2Skill 开源

把人类教程自动变成智能体可调用的技能

A general framework for distilling human-created multimodal resources into reusable,···

★ 557 2026-11-03
mcp-tts 开源

给 AI 接上语音嘴,一行配置接入多种 TTS 服务

MCP Server for Text to Speech

★ 74 2026-08-09
postman-mcp-server 开源

让 AI 助手直接调用你的 Postman 集合,自动生成和测试 API 代码

Postman MCP Server — connect AI agents (Claude Code, Cursor, VS Code Copilot, Gemin···

★ 331 2026-08-09
skills 开源

让 AI 智能体直接生成数字人视频,一句话搞定视频制作

HeyGen AI agent skills — avatar creation and video production via the v3 Video Agen···

★ 550 2026-08-09
claude-skills 开源

让 Claude 掌握网站全流程技能,从建站到优化一步到位

Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, con···

★ 1080 2026-08-09
EvoMaster 开源

让科研智能体边跑边进化,把实验迭代自动化

EvoMaster: A Foundational Evolving Agent Framework for Agentic Science at Scale.

★ 232 2026-10-13
Hermes-CN-Desktop 开源

在 Windows 桌面上,用轻量 Tauri 壳跑起隔离的 Hermes 智能体。

Hermes Agent CN desktop app, Windows-First, built with Tauri, Typescript and Rust. I···

★ 1939 2026-08-09