项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-01 · 当前星标 ★ 3484
使用教程
环境要求
- macOS:需安装 Homebrew,用于 brew 安装 Beacon
- Linux:支持 Debian/Ubuntu 与 Fedora/RHEL/Rocky/Alma,架构为 x86_64 或 arm64
- Windows:使用 x64 MSI 安装包
- 网络可访问 GitHub Releases 以下载安装脚本或安装包
- Linux 用 apt/dnf 安装 .deb/.rpm 需要 sudo 权限,无 root 时可改用用户模式 tarball
安装与启动步骤
-
1macOS 安装
先信任并添加 asymptote-labs/tap,再安装 beacon,最后执行 endpoint install 完成本机端点初始化。
brew trust asymptote-labs/tap brew tap asymptote-labs/tap brew install beacon beacon endpoint install -
2Linux 脚本安装
官方安装脚本会自动识别架构、下载对应 deb/rpm 包、用 checksums.txt 校验后交给 apt-get 或 dnf 安装。
curl -fsSL https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh | bash -
3先审脚本再执行
不想把脚本直接管道进 shell,可先下载保存并阅读内容,确认无误后再用 bash 运行。
curl -fsSLO https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh less install.sh bash install.sh -
4Linux 手动安装
自行确定版本与架构,下载包和 checksums.txt,用 sha256sum 校验后交给 apt 或 dnf 安装;Fedora 等改用 rpm。
VERSION="$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/asymptote-labs/agent-beacon/releases/latest)"; VERSION="${VERSION##*/v}" case "$(uname -m)" in x86_64) ARCH=amd64 ;; aarch64) ARCH=arm64 ;; esac FORMAT=deb # or rpm for Fedora, RHEL, Rocky, Alma PKG="beacon_${VERSION}_linux_${ARCH}.${FORMAT}" BASE="https://github.com/asymptote-labs/agent-beacon/releases/download/v${VERSION}" DIR="$(mktemp -d /tmp/beacon-install.XXXXXXXX)" && chmod 0711 "$DIR" && cd "$DIR" curl -fsSLO "${BASE}/${PKG}" && curl -fsSLO "${BASE}/checksums.txt" && chmod 0644 "${PKG}" grep " ${PKG}$" checksums.txt | sha256sum --check - && \ sudo apt install "./${PKG}" -
5Windows 安装
从最新 release 页面下载 x64 MSI 后用 msiexec 安装,加 /qn 参数可静默安装。
msiexec /i BeaconEndpointAgent-<version>-x64.msi -
6初始化端点
安装完成后运行 beacon endpoint install,交互式设置会引导登录并连接本机端点。
beacon endpoint install
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
BEACON_VERSION | 否 | 指定要安装的具体版本,而非跟随 latest。 | BEACON_VERSION=1.2.3 |
如何确认成功
安装命令(brew install / install.sh / msiexec)无报错,且 `beacon endpoint install` 交互式设置顺利走完,即视为安装成功。
常见问题
Q:安装时会不会自动上传数据或强制登录?
A:交互式 endpoint 设置会通过 beacon.sh 登录并预选 Beacon Cloud,签入不转发任何内容;你可显式选择 Local 退出。系统、包管理、MDM、CI 安装路径均为非交互且无需账号。
Q:checksums.txt 校验能证明安装包安全吗?
A:只能发现下载损坏或被替换,不能证明是谁构建了该版本。若在意来源可信度,请把 VERSION 固定到你已审阅过的版本,而不要跟随 latest。
Q:Linux 上没有 root 权限怎么办?
A:README 提到可改用用户模式(user mode)的 tarball 安装,具体步骤见官方 Linux 安装指南 without-root 章节。
Q:执行 install.sh 时提示 Permission denied 是失败了吗?
A:不是。README 明确说明这是 APT 结束时的一条无害提示,安装本身已完成。
注意事项
- 交互式 endpoint 设置默认选中 Beacon Cloud,签入不上传任何内容,确认页面在你接受前会说明这一点,可选择 Local 退出。
- 系统、包管理、MDM 和 CI 安装路径保持非交互且无需账号。
- checksums.txt 随 release 发布,仅用于发现损坏或被替换的下载,不验证发布者身份。
- Windows MSI 命令中的 <version> 需替换为实际下载到的版本号。
核心亮点
- 跨 harness 统一记忆层,Claude Code、Codex、Cursor 等工具可共享上下文
- 用 Go 编写,性能好、部署轻量,适合本地或云端运行
- 自带自我进化机制,记忆随使用逐步优化而非静态存储
不足之处
- 项目处于成长早期,生态与文档完善度有待观察
- 跨工具记忆同步的实际效果依赖各 harness 的接入深度
适用场景
- 在多个 AI 编程助手之间切换时保持项目上下文一致
- 团队共享智能体记忆,新成员快速获得历史决策背景
- CI 流程中让智能体记住构建与测试经验,减少重复排查
替代项目
mem0、Letta、Zep
上一篇:celesto
同类项目推荐
ling-stack
开源
自带模型,本地管好 AI 队友的对话与审批
Local-first AI teammate workspace. Bring your own models and keep project conversati···
skill-base
开源
一键发布、安装、回滚团队 AI 代理技能,跨工具统一管理。
Private Skill distribution platform for AI coding agents: publish, install, update, ···
PromethAI-Backend
开源
让 AI 智能体帮你定目标、做决策,并一步步执行落地。
Open-source framework that gives you AI Agents that help you navigate decision-makin···
ai--manus
开源
在沙箱里让大模型真正动手跑工具
AI Manus is a general-purpose AI Agent system that supports running various tools an···
OpenOSINT
开源
用自然语言驱动 OSINT 工具链,快速完成开源情报收集与分析。
Open-source OSINT agent: 21 public-source tools behind natural-language chat, an MCP···
wx-assist
开源
本地微信 AI 助手,群聊摘要、关键词提醒、语义搜聊天
「摘星」· 微信助手 — AI Agent 智能助手 / AI 群聊摘要 / 关键词即时提醒 / 公众号摘要···
mcp
开源
让 AI 工具直接调用 RunAPI,一键完成模型发现、媒体生成和余额管理。
RunAPI MCP server for model discovery, pricing lookup, media task creation, and bala···
agents
开源
在 Cloudflare 边缘一键构建部署有状态 AI 智能体
Build and deploy AI Agents on Cloudflare
MineStudio
开源
一键搞定 Minecraft 智能体数据与环境,专注训练算法
MineStudio: A Streamlined Package for Minecraft AI Agent Development