
numbat
给终端上的 AI 智能体装上监控和刹车,看清行为、阻止风险。
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1163
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- macOS、Linux 或 Windows(发布包支持 amd64 / arm64)
- 使用 go install 方式需 Go 1.26.6 或更新版本
- 从源码构建静态二进制时需设置 CGO_ENABLED=0
安装与启动步骤
-
1确认 Go 环境
若打算用 go install 安装,先确认本机 Go 版本不低于 1.26.6;直接下载发布包可跳过此步。
go version -
2用 go install 安装
README 推荐的方式之一,会把 numbat 命令安装到 Go 的 bin 目录,@latest 表示取最新版本。
go install github.com/perplexityai/numbat/cmd/numbat@latest -
3或下载发布包
在 GitHub Releases 页面按系统选择 macOS、Linux、Windows 及 amd64 / arm64 的发布包,每份发布都附带 SHA-256 校验和。
-
4从源码构建(macOS/Linux)
在代码检出目录执行,CGO_ENABLED=0 生成静态二进制,-trimpath 去除构建路径信息。
CGO_ENABLED=0 go build -trimpath -o numbat ./cmd/numbat -
5从源码构建(Windows)
在 PowerShell 中于代码检出目录执行,注意数值 0 需要加引号,输出文件名为 numbat.exe。
$env:CGO_ENABLED = "0" go build -trimpath -o numbat.exe ./cmd/numbat
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
enforce | 否 | 规则中标记 enforce: true 才会阻断,默认仅监控 | enforce: true |
如何确认成功
README 未给出启动或自检命令;可确认 go install 生成的二进制或解压后的 numbat 可执行文件已存在。
常见问题
Q:阻断功能默认是开启的吗?
A:不是。enforce 模式默认关闭,且只对标记 enforce: true 的规则生效,官方附带的所有规则均为仅监控模式。
Q:支持哪些操作系统和架构?
A:发布包覆盖 macOS、Linux、Windows,架构支持 amd64 与 arm64,并附带 SHA-256 校验和。
Q:没有提前装 numbat 的会话能回溯吗?
A:可以。取证重建功能可从支持的磁盘会话产物还原,无需事先对目标做过 numbat 插桩。
Q:对 Go 版本有什么要求?
A:使用 go install 安装需要 Go 1.26.6 或更新版本;使用官方发布包则无需 Go 环境。
注意事项
- 阻断为可选能力,且仅限支持的同步 pre-action 钩子,主机与面覆盖范围以 docs/agent-coverage.md 的矩阵为准。
- 检测在设备本地执行,记录可输出到 stdout 或本地文件,也可选择通过 HTTP 投递。
- 产物扫描为只读方式,并对密钥做脱敏处理。
- README 的 Quick start 只包含 Install 部分,未提供运行命令,实际使用请参考仓库 docs 下的覆盖矩阵与执行指南。
核心亮点
- 设备端检测,无需云端依赖,保护隐私且实时性高
- 支持操作前阻断,可主动拦截高风险行为
- 提供取证重建,便于事后审计和攻击溯源
不足之处
- 早期项目,文档和社区生态尚待完善
- 仅覆盖终端活动,对网络或API层面的智能体行为监控有限
适用场景
- 安全团队监控终端上运行的AI编程助手(如Copilot)
- 企业防止内部AI智能体执行敏感操作(如删除文件、访问密钥)
- 安全事件响应中对AI智能体行为的取证分析
替代项目
falco、sysdig、eBPF-based security tools
同类项目推荐
clampdown
开源
给AI代理套上安全沙箱,放心跑代码不越界
Run AI coding agents in hardened container sandboxes.
open-connector
开源
一键连接千款 SaaS,让 AI 智能体轻松调用外部工具
Open-source auth gateway connecting 1500+ SaaS providers to AI agents through SDK, C···
mav
开源
实时看模型训练过程,快速定位训练问题
Model Activity Visualiser
gguf-parser-go
开源
解析 GGUF 文件,算清显存占用和推理速度
Review/Check GGUF files and estimate the memory usage and maximum tokens per second.
VelesDB
开源
一个二进制搞定 Agent 记忆,召回还能给出证据链
The explainable, local-first memory engine for AI agents. One ~9 MB binary fuses vec···
distill
开源
给 LLM 智能体装上持久记忆,12 毫秒去重防泄露
Context intelligence layer for LLM agents: persistent memory with write-time dedup, ···
yantr
开源
自托管 AI 应用商店,一站式安装管理你的 AI 工具
A self-hosted homelab app store for rootless Podman — runs alongside your OS, not i···
containers
开源
一键拉取 Runpod 镜像,快速跑通 Stable Diffusion 生成任务
| Dockerfiles for the Runpod container images used for our official templates.
kiwi-mem
开源
给 AI 伴侣装上会遗忘、会做梦的长期记忆
Self-hosted memory gateway for AI companions — OpenAI-compatible proxy with vector ···