ApodexAI/FrontierAgent

项目概览

该项目把安全沙箱（/inputs 只读、/workspace 工作区、/outputs 交付物，失败即关闭）、变更审批与 /revert 回退、会话检查点恢复，以及隔离子进程的基准评测套件整合进一个命令行运行时，框架、工具、工作流与评测层彼此分离、可独立复用。

项目类型

AI Agent · AI 工作流 · 评测观测

应用场景

搜索调研 · 自动化执行

部署方式

查看项目说明

License

Apache-2.0

适合谁

• 需要在终端中运行开源智能体完成长程研究与文件工作的开发者和 AI 工程师
• 需要审批、沙箱与会话恢复机制来约束智能体文件操作的用户
• 需要评测套件来衡量智能体表现的研究人员

核心能力

• 单个有状态智能体执行研究、读取文件、撰写交付物、运行命令并在任务级沙箱中迭代。
• 协调者维护任务板，将独立工作委派给并行子智能体，收集报告并合成最终结果。
• /inputs 只读，/workspace 保存工作状态，/outputs 存放交付物；授权与沙箱失败均按关闭处理。
• 变更操作显示 diff 并需审批（除非启用 --yes）；会话被检查点保存，操作在本地留痕，/revert 恢复变更，--resume 继续已保存的运行。
• 每个基准问题在隔离子进程中运行，支持可恢复的多轮实验以及确定性或基于模型的评判。

限制与风险

• 运行需要一个 OpenAI 兼容的模型端点（通过 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL 配置），项目默认不捆绑模型托管，产生对端点服务的外部依赖。
• 安装与配置涉及 Git、Python 3.12、uv 与 .env 环境变量设置，交互方式为 CLI。
• 成本依赖与遥测情况未在文档中说明；GPU 为可选项；数据边界为外部可选（取决于所配端点）。

如何开始

• 需要 Git、Python 3.12、uv，并通过 .env 配置一个 OpenAI 兼容端点；安装难度为中等，主要源于依赖工具链与多条安装路线。
• 克隆仓库后执行 uv sync --python 3.12 --extra dev；复制 .env.example 为 .env 并填入端点密钥；然后运行 uv run frontier-agent --mode react --cwd /path/to/project 启动。

核验依据

• GitHub 项目简介: 🧩 FrontierAgent, our agent framework, open-sourced alongside it — native command-line TUI, ReAct and Agent Team modes, one command on macOS and Linux, no preinstall, no hard Docke…
• README: FrontierAgent is an open-source agent runtime, terminal product, and evaluation suite for long-horizon research and file-based work.
• README: Sandboxed file work. Shell and file tools share one task-scoped filesystem: `/inputs` is read-only, `/workspace` is working state, and `/outputs` contains persistent deliverables.…
• README: The framework, tools, workflows, and evaluation layer remain separate, so each can be reused independently.
• README: Requirements: Git, Python 3.12, [uv](https://docs.astral.sh/uv/), and an OpenAI-compatible model endpoint. Docker is optional.

来源更新时间：2026-09-28T18:39:02Z

打开原始 GitHub 项目