Atomic Agent – 本地优先的 AI 代理
在你的设备上本地运行控制循环和所有状态，驱动浏览器、编辑文件、执行经批准的命令，并支持长期上下文记忆的 AI 代理。
- Star 数
- ★ 3.4k
- 最近更新
- 3 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 56/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 在本地开发环境中，开发者使用 Atomic Agent 通过 TUI 或 CLI 管理浏览器自动化、文件操作和 shell 命令，同时保持代码和本地数据私密。
- 不适合
- 需要稳定 API 的团队：开发者预览阶段，接口与配置仍在变动
- 只有 arm64 或非 Linux x64 机器且不想手动配置 llama-server 的用户
- 不愿接受默认匿名使用分析、需要完全无遥测环境的团队
- 源码审查
- 56/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Atomic Agent 是一个本地优先的 AI 代理，核心控制循环和状态存储都在用户自己的机器上运行，而非托管服务。它通过 playwright-core 驱动浏览器，支持文件读写编辑、执行 shell 命令、文档文本抽取、Git 只读操作，并具有记忆、任务调度、技能、MCP 和 Telegram 远程控制等能力。代理循环基于 llama.cpp，默认使用本地量化模型，通过 TurboQuant 优化获得更高吞吐量。所有会话、记忆、任务、追踪等状态以普通文件和 SQLite 数据库形式存储在本地磁盘上，且提供审批门控、追加式追踪和提示漂移回放等安全与可观测性特性。它可以通过 CLI、TUI、HTTP 服务或嵌入为 Tauri sidecar 使用，并支持从 Hermes 或 OpenClaw 导入。
Atomic Agent 执行一个推理与工具调用的循环：它通过 llama-server 调用本地模型，模型返回一个 JSON 数组的工具调用，核心执行器并行运行只读调用，对危险操作进行审批门控，然后将结果压缩并循环直到完成。具体功能包括：使用 playwright-core 进行浏览器自动化（导航、点击、输入、搜索、标签页管理、滚动、读取 ARIA 快照）、Web 搜索（支持 Exa、DuckDuckGo、Brave、SearXNG）、HTTP 请求（带 SSRF 防护）、文件读写编辑、shell 命令执行（需要审批）、本地 PDF/DOCX 等文档文本抽取、Git 只读操作（status, log, diff, show, blame）、记忆（配置文件事实、笔记、链接、课程、程序）与投票、任务调度（cron、webhooks）、技能（Markdown 剧本，如 Docker、GitHub、Notion），以及 MCP 客户端集成。它还提供 Telegram 单用户远程控制，支持配对、审批按钮和可选的任务报告。
- 在本地开发环境中，开发者使用 Atomic Agent 通过 TUI 或 CLI 管理浏览器自动化、文件操作和 shell 命令，同时保持代码和本地数据私密。
- 希望从 Hermes 或 OpenClaw 迁移的用户，可以使用 /import 命令一键导入会话、cron 任务和提供商密钥。
- 需要长期运行多步骤任务的用户，通过记忆和任务调度功能，使代理跨会话记住上下文并安排后续操作。
- 在离线和隐私敏感的环境（如医院、金融）中，使用本地量化模型运行代理，避免将数据发送到外部 API。
- 构建桌面应用的开发者，通过 Tauri sidecar 或 OpenAI 兼容的 HTTP API 嵌入该代理到自己的应用中。
- 需要远程控制个人代理的用户，通过 Telegram 机器人进行配对、审批和执行任务。
如何安装或部署这个 Agent？
Atomic Agent 提供一键安装脚本。在 macOS/Linux 上运行：chmod +x install.sh && curl -fsSL https://atomicagent.io/install | sh。在 Windows PowerShell 上运行：irm https://atomicagent.io/install.ps1 | iex。安装完成后会下载发布压缩包、验证校验和，并安装 CLI 及支持资源（grammars、原生预编译和捆绑的 ripgrep）。需要 Node.js >= 25.7（开发时），运行时需要可用的 llama-server（可由 CLI 管理或外部提供）、Chromium 系列浏览器（Chrome、Edge 等）和 git。
如何使用这个 Agent？
安装后，在终端运行 atomic-agent tui 启动交互式控制台，或使用 atomic-agent run --cwd /path/to/work 运行简单会话。可以通过 CLI 管理模型：atomic-agent models update、atomic-agent models pull qwen-3.5-4b、atomic-agent models use qwen-3.5-4b。若使用外部 llama-server，可设置环境变量 ATOMIC_AGENT_LLAMA_URL=http://127.0.0.1:8080 并启动服务器。对于本地 HTTP 服务，运行 atomic-agent serve --host 127.0.0.1 --port 8787 --cwd /path/to/work --api-key $ATOMIC_AGENT_API_KEY。作为 Tauri sidecar 嵌入时，通过 stdio 发送 newline-delimited JSON 请求。Telegram 远程控制需要在 config.json 中启用，并设置 TELEGRAM_BOT_TOKEN。
这个 Agent 有哪些优点和局限？
- 本地优先，控制循环和状态在本地，无每 token 费用，隐私可控。
- 针对本地小模型优化，采用 TurboQuant KV-cache 和 speculative decoding，性能优于通用方案（GAIA L1 达 69.8%）。
- 提供丰富的工具表面，包括浏览器、文件、shell、文档、Git、记忆、任务、技能和 MCP。
- 安全和可观测性完善，具备审批门控、追加式追踪、提示漂移回放、失败分类和防停滞守卫。
- 支持多种使用方式：CLI、TUI、HTTP 服务、Tauri sidecar 和 Telegram 远程控制。
- 仍处于开发者预览阶段，API、命令、配置和行为可能变化，需要固定版本。
- 需要配置 llama-server 和浏览器，无捆绑浏览器，外部 llama-server 需手动启动（或使用托管模式）。
- 默认开启匿名使用分析和崩溃报告，需手动关闭。
- 仅支持 Linux x64 的托管本地模型，其他平台（如 arm64）需要外部 llama-server。
- 需要 Node.js >= 25.7，版本要求较高，可能限制了旧系统。
这个 Agent 与同类方案有什么区别？
与 Hermes 相比，在 GAIA Level 1 基准上，Atomic Agent 使用相同的本地模型获得 69.8% 的准确率，而 Hermes 为 58.5%，且平均每任务时间更短（约 217 秒对 351 秒）。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Atomic Agent – 本地优先的 AI 代理 当前 | 56 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.4k | 3 天前 | TypeScript | — |
| Aiden | 65 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 858 | 1 个月前 | TypeScript | ChatGPT · OpenAI API · Claude API |
| Auto Browser | 62 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 908 | 今天 | Python | OpenAI API · Claude API |
| Octopal | 61 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 10 | 2 个月前 | Python | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示有审批门控（shell、文件写入、HTTP等）、隐私与出口说明、匿名分析默认开启但可关闭、状态文件本地存储。扣分：敏感数据处理不完整（.env secrets 继承给技能和shell）、依赖安全未提供审计或锁定、回滚机制仅提及更新提示重启、来源归属未验证发布者。
自洽性：README与package.json描述一致，功能列表与代码结构相符。依赖可用性：Node>=25.7要求较高，可能限制环境；未提供依赖锁定文件。失败消息：有故障分类和错误处理说明，但未提供具体示例。
受众明确（开发者、本地模型用户），场景多样（TUI、CLI、HTTP、sidecar、Telegram）。能力边界清晰（工具列表、审批门控）。触发精度：命令和配置明确。环境适配：支持多平台，但Linux依赖外部工具，浏览器未捆绑。
信息架构清晰（README结构完整）。安装说明详细（curl、PowerShell）。命名稳定性：API和命令仍在变动，提示pin版本。示例和FAQ：有示例命令和配置，但无FAQ。已知限制：有开发者预览说明和平台限制。许可证：MIT。版本变更日志：未提供CHANGELOG，但版本号存在。维护责任：未明确维护者，发布者未验证。
输出可用性：提供多种使用方式，输出格式明确。边际价值：本地优先、无API费用、可检查状态，有独特价值。成本效益：本地模型降低API成本，但需要硬件和配置。
声明可追溯：GAIA基准有文档和原始数据链接，但未提供完整复现步骤。跨来源佐证：仅单一来源，未独立验证。事实与推断分离：README区分了事实和推断，但部分声明（如性能提升）缺乏独立验证。
- 发布者未验证，身份未知。
- 敏感数据处理不完整：.env secrets 可能被技能和shell命令继承，需谨慎。
- 依赖安全未提供审计或锁定，建议检查依赖漏洞。
- API和命令仍在变动，生产使用需固定版本。
- 匿名分析默认开启，需注意隐私。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
The desktop app is updated too: [Desktop v0.0.3](https://github.com/AtomicBot-ai/atomic-agent/releases/tag/desktop-v0.0.3). From this release on, the terminal agent and the desktop app share one setup. One setup for the terminal and the desktop - The desktop app now uses the terminal agent's folder, ~/.atomic-agent. Chats, memory, skills, keys and settings are the same in both. - Both can run at once. Quitting one no longer stops a local model the other is using. - Scheduled tasks run once, in whichever app was started first. Telegram works the same way. …在 GitHub 查看 ↗ -
desktop-v0.0.3 Desktop v0.0.3
发布说明摘录
The desktop app now shares one setup with the terminal agent, and you can attach files and images to a message. It includes everything in Atomic Agent v0.6.9. One setup with the terminal - The app now uses the same folder as the terminal agent, ~/.atomic-agent. Chats, memory, skills, keys and settings are shared. - Already using the desktop? On first start, your data from ~/.atomic-agent-desktop comes over once: - a backup is made first; - where both apps have a setting, the terminal's wins; - local model files are moved, not downloaded again; - the old folder is kept; …在 GitHub 查看 ↗ -
发布说明摘录
The desktop app is updated too: [Desktop v0.0.2](https://github.com/AtomicBot-ai/atomic-agent/releases/tag/desktop-v0.0.2). Atomic Chat Core is the local engine - Local models now run through Atomic Chat Core, the engine the Atomic Chat app uses. It downloads and manages llama.cpp for you. Existing setups move over on first start (config v77). Your model files are kept and nothing is downloaded again. - The engine choice is no longer shown in the TUI. atomic-agent models engine llama-server switches back if you need to. …在 GitHub 查看 ↗