项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-13 · 当前星标 ★ 5434
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Git(用于克隆仓库)
- Python 3.12
- uv(Python 包管理器,需提前装好)
- 一个 OpenAI 兼容的模型端点(API Key、Base URL、模型名)
- macOS 或 Linux;Windows 需通过 WSL2 按 Linux 处理
安装与启动步骤
-
1克隆项目仓库
从 GitHub 拉取 FrontierAgent 源码并进入项目目录,后续命令都在该目录下执行。
git clone https://github.com/ApodexAI/FrontierAgent.git cd FrontierAgent -
2同步 Python 依赖
用 uv 按 Python 3.12 创建虚拟环境并安装依赖,含 dev 附加依赖,无需手动 pip。
uv sync --python 3.12 --extra dev -
3生成配置文件
从模板复制出 .env 文件,下一步在里面填写模型端点信息,不要提交该文件。
cp .env.example .env -
4填写模型端点
编辑 .env,填入你的 API Key、OpenAI 兼容端点地址和模型名,缺一不可。
-
5按平台完成启动
README 未给出统一启动命令,请按系统(macOS/Linux/GPU 平台/WSL2)查对应安装文档再启动。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 是 | 访问模型端点的密钥 | your-key |
OPENAI_BASE_URL | 是 | OpenAI 兼容模型端点地址,需带 /v1 | https://your-openai-compatible-endpoint/v1 |
OPENAI_MODEL | 是 | 要调用的模型名称 | your-model-name |
如何确认成功
启动后终端出现 frontier-agent TUI 界面,并能看到 ReAct 与 Agent Team 两个工作流入口即成功。
常见问题
Q:必须装 Docker 吗?
A:不需要。Docker 是可选的,原生方式只需 Git、Python 3.12、uv 和一个模型端点即可运行。
Q:没有 OpenAI 官方密钥能用吗?
A:可以。只要端点兼容 OpenAI 接口,把 OPENAI_BASE_URL 和 OPENAI_MODEL 换成对应值即可。
Q:Windows 上怎么装?
A:Windows 通过 WSL2 运行,按 Linux 的安装方式处理,模型端点需是 WSL2 能访问到的地址。
Q:中文安装文档在哪?
A:macOS 中文用户可查看仓库内 docs/install/macos.zh-CN.md 的中文安装与一键启动指南。
注意事项
- Docker 只是可选方案,FrontierAgent 本身不强制容器化。
- 操作系统、Agent 运行时与模型运行时是三个独立选择,README 中“NVIDIA”指本地模型服务而非 Agent 运行方式。
- 不确定该选哪种安装方式时,先看 docs/install/README.md 的安装选择器。
- 模型端点地址需包含 /v1,具体以你的服务商文档为准。
核心亮点
- 一条命令即可在 macOS/Linux 启动,无需预装依赖或 Docker,上手门槛极低
- 同时提供 ReAct 单体和 Agent Team 多智能体两种模式,覆盖从简单任务到协作编排
- 原生 TUI 交互,在终端内即可观察和干预 Agent 执行过程,调试直观
不足之处
- 仅支持 macOS 与 Linux,Windows 用户无法直接使用
- 项目处于成长阶段,生态、插件和文档完善度相比成熟框架仍有差距
适用场景
- 开发者在终端里快速验证一个 Agent 任务流程,无需搭建容器环境
- 用多智能体团队模式拆分并并行处理复杂调研或编码任务
- 把 Agent 能力集成进已有命令行工具链,做自动化运维或脚本编排
替代项目
LangChain、AutoGen、CrewAI
上一篇:kiss_ai
同类项目推荐
harnessNovel
开源
拆书仿写,驱动百万字长篇小说自动连载,告别 AI 味。
长篇网络小说自动化写作 AI Agent,支持Chatgpt、gemini、Deepseek等国内外模型接入,采用···
Master-skill
开源
让 AI 化身佛教导师,回答有经可依、有界可守
FoJin-powered Buddhist AI persona framework — source-grounded, boundary-aware, fide···
LightMem2
开源
给 AI 代理装上轻量记忆,长任务不迷路
[EMNLP 2026] LightRSI is a modular runtime for lightly deploying recursive self-impr···
chatgpt2codex
开源
让ChatGPT直接操作你的macOS项目,执行编码与测试
macOS-first local MCP and Actions runtime that gives ChatGPT real coding hands over ···
TradingAgents
开源
一群 AI 参谋帮你盯盘,交易决策更稳当
TradingAgents: Multi-Agents LLM Financial Trading Framework
skills
开源
给编码代理装上 NVIDIA 专业技能,物理 AI 和机器人开发开箱即用。
Agent Skills for NVIDIA products — install into Claude Code, Codex, and other codin···
openaccountants
开源
给 AI 装上专业税务大脑,问答更靠谱
Open tax skills for AI: 2,250 skills across 266 jurisdictions, every figure cited to···
FlowVision
开源
一键把项目代码变成架构图,还能和 AI 联动
FlowVision,一键分析项目代码 · 自动生成架构流程图 · 可视化编辑 · MCP 实时同步
Patter
开源
四行代码给AI代理装电话,开源可控的语音SDK。
Open-source voice-AI SDK. The Vapi/Retell alternative for builders who want to own t···
