Atomic Agent：本地优先 AI 智能体

项目简介

Atomic Agent 是一个本地优先（local-first）的 AI 智能体：控制循环与全部状态都运行在你自己的机器上，而不是托管服务。它基于项目的 TurboQuant llama.cpp 运行开放权重模型，让小型量化模型在消费级硬件上也能支撑长时间、多步骤的任务。

模型可以只跑本地、只走云端，或在 Fusion 模式下同时使用两者——由一个模型负责规划，一组 worker 负责执行。它也可以作为 HTTP 服务或 Tauri sidecar 嵌入到你自己的应用中。项目主要语言为 TypeScript，采用 MIT 许可证。

主要功能

• 跨机器工作：浏览网页、读写文件、执行经你批准的 shell 命令、查看文档。
• 跨会话记忆上下文，可安排后续任务。
• 通过 MCP 调用外部工具。
• 支持本地模型与云端模型，或 Fusion 组合模式。
• 安装包自带支持资源：grammars/、原生预构建、内置 ripgrep。
• 支持自更新：atomic-agent update，--check 仅探测新版本，--version <tag> 固定某个版本。
• TUI 中按 Ctrl+N（或 /window）可在同目录下新开一个终端窗口运行新的智能体。
• 首次运行可把其他智能体的数据导入进来，之后也可用 /import 或 atomic-agent import <hermes|openclaw|claude-code|codex|pi|oh-my-pi>。
• 一条命令完成卸载：atomic-agent uninstall，支持 --dry-run、--keep-data、--keep-binary、--keep-path、--yes 等选项。

在公开的 GAIA validation Level 1 划分（53 个任务）上，用同一个本地 qwen-3.6-35b-a3b 模型对比，Atomic Agent 准确率 69.8%（37/53），Hermes 为 58.5%（31/53）；平均每题耗时分别为约 217 秒与 351 秒。同一循环在更小的模型上同样可用：qwen-3.5-9b（Q4_K_M）为 52.8%，gemma-4-12b 为 45.3%。

安装与使用

macOS / Linux：

curl -fsSL https://atomicagent.io/install | sh

Windows（PowerShell）：

irm https://atomicagent.io/install.ps1 | iex

Linux 上还可以用包管理器安装（Debian/Ubuntu、Fedora/RHEL/Rocky/Alma、Arch 的 AUR），之后随系统一起升级；另有独立的桌面应用包 atomic-agent-desktop，可与命令行走装并存。

安装完成后运行：

atomic-agent

也可以用安装器放在旁边的短别名 atag。想重新走一遍初次设置，在 TUI 中执行 /onboarding（或 atomic-agent tui --onboarding），已有的 provider、密钥、会话与记忆会保留。

注意事项

• 目前是开发者预览版（Developer preview），API、命令、配置与行为仍会变动；需要稳定集成点时请固定到某个 release。
• 当前构建：macOS（Apple Silicon）、Linux x64 / arm64、Windows x64；暂不支持 Intel Mac，Windows on ARM 以模拟方式运行 x64 构建。
• Linux 包要求 glibc 2.34（Debian 12、Ubuntu 22.04、RHEL 9 及更新版本）。
• atomic-agent uninstall 会删除状态目录（配置、记忆、会话、任务、轨迹、已下载模型）等数据，操作不可撤销，可用 --dry-run 先预览。

本作品整理自 GitHub 开源项目 AtomicBot-ai/atomic-agent，原作者 @AtomicBot-ai，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。