
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 10291
技术标签
使用教程
环境要求
- macOS(Apple Silicon/Intel,macOS 26+ 需 FSKit 与签名审批)或 Linux(GNU/MUSL,需 FUSE),本次归档不
- 已把解压出的目录加入 PATH,并保持伴随二进制与平台文件在一起
- 从 crates.io 安装需 Rust 1.95+
- 源码编译需已安装 Rust 与 Cargo 工具链
安装与启动步骤
-
1Homebrew 安装
macOS 与 Linux 均可用 Homebrew 方式安装,先添加官方 tap 再安装 astrid。
brew tap astrid-runtime/tap brew install astrid -
2cargo 安装
已装 Rust 1.95+ 时可直接从 crates.io 安装,但这不是签名 macOS 包(缺文件系统提供程序)。
cargo install astrid -
3源码编译
克隆仓库后编译 release,产物为 ./target/release/astrid,可自行复制到 PATH。
git clone https://github.com/astrid-runtime/astrid cd astrid && cargo build --release -
4验证并启动
确认版本后启动运行时;未组合的运行时不需要模型账号或发行版。
astrid --version astrid start astrid status -
5查看胶囊并停止
列出已安装胶囊,确认没有产品胶囊属正常;停止会把工作状态归入 astrid.volume。
astrid capsule list astrid stop -
6初始化发行版
发行版提供胶囊组合与配置,Astrid 不会隐式选择;密钥在交互提示中按 principal 存储。
astrid init --distro @yourorg/your-distro -
7检查并进入会话
doctor 检查守护进程、胶囊与 LLM 是否就绪;chat 首次使用会自动拉起守护进程。
astrid doctor astrid chat astrid models
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--distro | 是 | 指定发行版来源:仓库、本地清单或离线签名包 | @yourorg/your-distro |
如何确认成功
astrid --version 正常输出版本,astrid status 显示守护进程正在运行即可。
常见问题
Q:Windows 可以安装吗?
A:不行。Windows 只在 CI 中测试,当前 2026.9.0 发布的归档不包含 Windows,请使用 macOS 或 Linux。
Q:macOS 上为什么需要额外审批?
A:macOS 26+ 使用 FSKit 作为文件系统前端,需要签名的 AstridFS 应用与扩展批准,否则挂载能力不可用。
Q:cargo install 能替代发布归档吗?
A:不能完全替代。平台归档还包含文件系统提供程序,macOS 上还有签名应用与管理脚本。
Q:Astrid 会自动帮我选发行版或模型吗?
A:不会。Astrid 不隐式选择发行版、模型提供方与智能体循环,需用 astrid init --distro 显式指定输入。
Q:停止运行后状态会丢吗?
A:不会。astrid stop 会把工作状态归入 astrid.volume,再次启动时恢复工作投影。
注意事项
- 解压发布归档时不要把伴随二进制与平台文件拆开,并把解压目录加入 PATH。
- 发行版初始化会写入 Distro.lock,按 BLAKE3 哈希固定每个胶囊,可复现同一套组合。
- 密钥只存入按 principal 的 secret store,不会通过命令行传递。
- 发行版含 LLM 提供方时可从 /v1/models 发现可用模型列表,用 astrid models 查看。
核心亮点
- 基于 Wasm 的沙箱隔离,提供强安全边界,适合运行不可信 AI 代码
- 能力安全模型,细粒度控制资源访问,避免权限滥用
- 微内核架构,模块化设计,易于扩展和定制
不足之处
- 项目较新,生态和文档仍在完善中
- Wasm 运行时性能相比原生仍有开销
- 学习曲线较陡,需要理解能力安全等概念
适用场景
- AI 智能体安全执行代码(如自动编程、数据分析)
- 多智能体系统隔离运行,防止相互干扰
- 边缘设备上运行可信 AI 应用
替代项目
wasmtime、Extism、Suborbital
上一篇:LoopTroop
下一篇:ai-job-search
同类项目推荐
openbot
开源
把多个AI编程助手变成能长期协作的本地队友
A local-first desktop workspace for persistent AI teammates. Run Codex, Claude, and ···
claude-capsule-kit
开源
让 Claude Code 变身工程团队,并行搞定复杂开发任务
A toolkit that makes Claude Code better at engineering — session memory, dependency···
home-generative-agent
开源
跟家聊天,一句话搞定自动化,摄像头异常主动报警
AI agent for Home Assistant — talk to your home, create automations in plain langua···
AgC
开源
为AI代理打造的大规模编排计算底座
AgC is the open-core platform that powers Open Agentic Compute — a new compute subs···
AI-company
开源
用 Claude Code 搭建你的 AI 虚拟团队,自动协作搞定复杂项目
Multi-agent team operating system for Claude Code. 108 MCP tools, 40+ agent template···
awesome-claude
开源
Claude 生态资源一站查找与分发
HeyClaude is a curated registry and distribution surface for Claude and AI-workflow ···
mcp-image
开源
让 AI 工具一键生成和编辑图片,自动优化提示词
MCP server for AI image generation and editing with automatic prompt optimization an···
intentlang
开源
用意图编程,让 AI Agent 直接执行你的想法
The next-generation AI Agent framework driven by Intent Engineering. Move beyond tur···
tenet
开源
让 AI 连续开发 12 小时,规格驱动+DAG 编排+三重评审,结果更靠谱。
Cross-platform AI agent harness for 12+ hour autonomous development cycles. Spec-dri···