项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1449
使用教程
环境要求
- macOS(Apple silicon/Intel)、Windows 或 Linux 系统
- 可用的 LLM 宿主或终端(如 Claude Code、Codex、Gemini CLI、Cursor 等)
- 已安装 git 并能访问 GitHub Releases(离线安装可跳过)
- macOS 需先安装 Xcode Command Line Tools
- 准备好自己要使用的模型账号或 API Key
安装与启动步骤
-
1检查基础依赖
macOS 需要命令行工具,其他平台可跳过第一步;用 git --version 确认 git 可用。
xcode-select --install git --version -
2一键安装运行时
从 GitHub Releases 下载发行包,安装 Hephaestus 运行器并为已支持的 LLM 宿主注册命令适配器。
curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/main/scripts/install-all-runtimes.sh | bash -
3可选:装全局路由
加环境变量后会在宿主的全局指令文件(如 ~/.claude/CLAUDE.md)写入路由块,让大任务可从智能体网络派工。
curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/main/scripts/install-all-runtimes.sh | HEPHAESTUS_INSTALL_GLOBAL_ROUTER=1 bash -
4可选:离线安装
已有本地源码时设置 HEPHAESTUS_SOURCE_DIR,跳过 GitHub 下载与校验,直接从本地 checkout 安装。
HEPHAESTUS_SOURCE_DIR=$(pwd) bash scripts/install-all-runtimes.sh -
5验证并开始使用
确认运行器文件已就位;在 LLM 中用 /agentlas 系列命令,在 shell 中用 agentlas 命令。
ls ~/.agentlas/runtime/current/bin/hephaestus -
6可选:Claude Code 插件
插件方式会加命名空间,只能得到 /hephaestus:agentlas;想要裸 /agentlas 请用一键安装器。
claude plugin marketplace add https://github.com/agentlas-ai/Agentlas-OS --sparse .claude-plugin claude/plugins claude plugin install hephaestus@agentlas-core-engine -
7可选:Codex 插件
这两条必须在系统终端运行,不能写在 Codex 应用内;应用内的浏览器命令是复数 /plugins。
codex plugin marketplace add agentlas-ai/Agentlas-OS --ref v1.2.44 codex plugin add hephaestus@agentlas-core-engine
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
HEPHAESTUS_INSTALL_GLOBAL_ROUTER | 否 | 设为 1 时向宿主全局指令文件写入任务路由块 | 1 |
HEPHAESTUS_SOURCE_DIR | 否 | 指向本地 checkout 目录,跳过在线下载与校验 | /path/to/checkout |
如何确认成功
看安装脚本输出的各运行时表面验证结果;确认 ~/.agentlas/runtime/current/bin/hephaestus 存在,且 /agentlas build 可用。
常见问题
Q:Claude Code 里为什么只有 /hephaestus:agentlas?
A:插件自带命名空间。想要文档里的裸 /agentlas 自动补全,改用一键安装器,它还会写入 ~/.claude/commands/agentlas.md 和 hep-*.md。
Q:Codex 中执行 /plugin marketplace add 报错?
A:该命令要在操作系统终端里跑,且是单数 codex plugin;应用内的插件浏览器命令才是复数 /plugins。Codex 0.117+ 已移除 /prompts:*,改用 $hephaestus-network。
Q:没有网络或需要气隙安装怎么办?
A:设置 HEPHAESTUS_SOURCE_DIR 指向本地 git clone 或已解压的发行包,安装器会跳过 GitHub 下载和校验步骤。
Q:装完需要重启宿主吗?
A:可能需要重启宿主或重新加载插件,安装脚本会明确说明该宿主的命令面是否已就绪。
Q:安装会写哪些目录?
A:只写入 ~/.agentlas、~/.local/bin 以及各宿主自己的插件/命令适配目录(如 Claude Code 的 ~/.claude)。
注意事项
- 安装脚本只动 ~/.agentlas、~/.local/bin 和宿主插件目录,不写入其他路径。
- 桌面版需到 agentlas.cloud/desktop 单独下载,支持 macOS、Windows、Linux。
- 更新检查在后台进行且限速,当前命令不会等待网络或安装完成。
- 项目不绑定模型厂商,使用你自己的模型账号或 API Key 在本机运行。
核心亮点
- 本地优先架构,数据不出设备,隐私安全有保障
- 支持任意模型,不锁定供应商,灵活切换
- 临时协调者模式,按需编排,避免常驻资源浪费
不足之处
- 项目较新,生态和文档尚待完善
- 多智能体通信依赖 A2A 协议,普及度有限
适用场景
- 个人或团队本地搭建多智能体协作工作流
- 需要隔离敏感数据的自动化任务处理
- 研究或实验不同模型在智能体协作中的表现
替代项目
AutoGen、CrewAI、LangGraph
同类项目推荐
docker-agent
开源
用 Docker 把 AI 智能体打包成镜像,随处运行
AI Agent Builder and Runtime by Docker Engineering
syftr
开源
花最少的钱,跑最快的AI代理工作流
syftr is an agent optimizer that helps you find the best agentic workflows for your ···
WhyBuddy
开源
输入产品想法,AI 帮你系统推演验证
A Simple and Universal Product Rehearsal Engine, Speccing Anything. 简洁通用的产品推···
contrabass
开源
用 TUI 指挥多个 AI 代理,协同搞定大型编码任务。
A project-level orchestrator for AI coding agents — Go & Charm stack implementation···
MLE-agent
开源
读论文、写代码、做研究,一个助手全搞定
MLE-Agent: Your intelligent companion for seamless AI engineering and research. Int···
eve-software-factory-template
开源
用智能体流水线自动把需求变成代码
Meet Foreman, an eve Software Factory.
nullclaw
开源
Zig 写的超轻量自主 AI 助手,启动快、占用小
Fastest, smallest, and fully autonomous AI assistant infrastructure written in Zig
VetarAI
开源
本地跑多Agent协作,数据不出门,RAG省缓存
VetarAI 是一款全原生 Swift 的本地桌面应用:多 Agent 协作、可视化工作流、拉模式知识仓···
fable-foreman
开源
让最强模型当领队,便宜模型干活,盲验把关质量
Turn Fable or Opus into your agent orchestrator: plan coding work, assign capable Cl···
