PrimeIntellect-ai prime-agent

Prime Agent：一个自我改进的RLM代理文档 • 验证器 • PRIME-RL • pi-mono

Prime Agent 是一个开源的编码和研究代理，适用于通用及长期运行的工作。它围绕两个核心抽象设计：

递归语言模型（RLM） 将上下文视为变量（提示即变量），并将递归子代理等工具视为持久 REPL 中的函数调用（程序化工具/子代理调用）。

持续框架（Continual Harness） 将补充提示、记忆、技能描述和可复用的子代理规范存储为持久状态，Prime Agent 可以通过小而基于证据的更新来优化这些状态，默认仅在会话本地生效。

Prime Agent 将持久化的 Python 控制环境与持久的框架状态相结合，使有用的工作上下文和可复用的操作模式能够超越单个聊天窗口而存在。一切都是程序化的：持久化 IPython 是内置的模型工具；文件操作、shell 命令、工具使用、子代理和上下文管理都通过代码实现。

子代理是内置的：rlm(...) 可以生成真正的子代理，用于并行或后台工作，并以编程方式返回其结果。

框架可以自我改进：/refine 审查当前轨迹，并可以对补充框架状态应用小而基于证据的更新。它从不重写不可变的基础系统提示，并且记录的快照支持回滚。

技能是可执行的：技能是可导入的 Python 包，内置的技能创建器可以将重复的工作流程转化为项目或个人技能。

会话在后台运行：守护进程支持的代理在终端断开时继续运行，之后可以重新连接。

代理直接通信：运行中的代理可以交换消息并相互编排，无需将所有内容都经由用户转发。

长任务持续推进：自动压缩、持久目标、心跳、计划、自主模式和保留的子代理可以在多轮对话和终端会话之间保持进度。

快速开始

在 macOS 或 Linux 上安装最新的稳定版本：

curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | sh

安装程序会下载一个带版本号的发布包，验证其 SHA-256 校验和，安装 prime-agent 命令，并可以准备代理使用的 IPython 运行时。

从你希望代理工作的仓库或目录启动 Prime Agent：

cd /path/to/project
prime-agent

首次启动时，运行 /login 选择订阅或 API 密钥提供商。Prime Agent 在当前目录中工作，可以运行命令并修改该目录中的文件。请使用一次性克隆、干净的工作树或其他你可以检查和恢复的检查点。

警告：Prime Agent 以你的用户权限执行模型生成的 Python 和项目命令。其工作进程和内核进程改善了生命周期隔离和恢复能力；它们不是安全沙箱。请审查更改，仅使用可信的仓库、指令、技能和扩展。在外部沙箱或受限环境中运行不受信任的代码或指令。

有用的命令：

prime-agent agents              # 浏览运行中、空闲和已保存的会话
prime-agent attach       # 重新连接到运行中的会话
prime-agent --resume   # 恢复已保存的会话
prime-agent status              # 检查后台服务状态
prime-agent doctor [--fix]      # 检查或修复后台服务
prime-agent update [--force]    # 更新 Prime Agent
prime-agent shutdown [--force]  # 停止所有代理、工作进程和后台服务

专为长期运行而设计

Prime Agent 专为长期运行的工作而设计，尤其是研究中的评估任务。以下功能在 TUI 中可用，也可以在自主模式下运行。

持续框架：/refine 可以将聚焦的、可审查的经验持久化为补充提示、记忆、可复用的技能描述或子代理规范，并记录优化历史。它不替代打包和审查新的可执行技能。

代理间直接通信：运行中的代理和保留的子代理可以发现彼此、交换消息并引导正在进行的工作。

守护进程支持的连续性：活动会话、IPython 状态、计划和子代理在终端分离后继续运行，之后可以重新连接。

心跳和计划：/heartbeat、rlm_heartbeat 和 prime-agent schedule 可以定期或在特定时间重新进入会话。

持久目标：/goal 保持目标和其进度在多轮对话中持续有效，直到完成、暂停或清除。

有界自主模式：/autonomous 在配置的轮次、令牌和时间预算内继续运行，并可以执行用户定义的质量门。通过的质量门只检查该门所验证的内容；达到限制并不表示任务成功。

文档

快速入门 — 安装、认证并运行第一个会话
用法和 CLI 参考 — 命令、会话、自主限制和输出模式
长期运行和后台代理 — 分离和重新连接、目标、心跳和计划
RLM 编程模型 — 持久化 IPython、子代理、技能和信任模型
JSON 模式和 RPC 模式 — 无头自动化和集成
技能 — 安装和创建可复用的能力
提供商设置 — 订阅和 API 密钥提供商
架构概述 — 守护进程、工作进程、内核和持久化边界
开发 — 从源码构建和运行

致谢

我们的代理和 TUI 构建在 pi 之上。我们感谢 pi 的作者们的宝贵工作。

许可证

Prime Agent 完全开源，基于 MIT 许可证发布。