atomic-agent

在本地设备上跑起长上下文 AI 智能体，隐私安全还支持工具调用

atomic-agent 是一个本地优先的 AI 智能体框架，专为本地大语言模型优化设计。它解决了云端 AI 依赖网络、隐私泄露和上下文受限的问题，让用户完全在设备上运行智能体。核心能力包括超长上下文窗口支持、规范的工具调用机制、浏览器自动化以及 CLI 交互。基于 TypeScript 构建，底层集成 llama-cpp 和 GGUF 模型，兼容 OpenAI API 协议，并支持 Playwright 驱动的浏览器操作。项目强调隐私保护，所有数据处理均在本地完成，适合对数据安全敏感的用户。其设计理念是轻量、模块化，开发者可快速集成到现有工作流中，实现自动化任务处理。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2545

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队AtomicBot-ai

所属国家

官网地址https://atomicagent.io

GitHubhttps://github.com/AtomicBot-ai/atomic-agent

定价模式free

价格说明开源项目，MIT许可证，本地优先，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agents,ai-agent,browser-automation,cli,gbnf,gguf,hermes-agent,llama-cpp,llm,local-ai-agent,local-first,local-llm,mcp,nodejs,openai,openclaw,playwright,tui,typescript

GitHub 星标★ 2545

30天Star增速

HF 下载量

上线时间2026-04-21 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

macOS(Apple Silicon)、Linux x64/arm64 或 Windows x64（当前发行版支持的平台）
需要可访问的 llama-server：由 atomic-agent models 托管启动，或在外部自行启动
需要 Chrome、Microsoft Edge 或其他 Chromium 内核浏览器，浏览器二进制不随安装包附带
需要 git，用于 git 工具；开发模式另需 Node.js（发行版为 Node SEA 二进制）
Linux 桌面工具建议安装 ripgrep、xclip/xsel 或 wl-clipboard、libnotify-bin、wmctrl、gio 或 tras

安装与启动步骤

1安装（macOS/Linux）

官方一键脚本会下载发行包、校验 checksum，并安装 CLI 及 grammars/、原生预构建和内置 ripgrep 等资源。
```
curl -fsSL https://atomicagent.io/install | sh
```
2安装（Windows）

在 PowerShell 中运行同样的安装流程，安装完成后会把 PATH 写入 shell 配置。
```
irm https://atomicagent.io/install.ps1 | iex
```
3启动 Agent

直接运行会进入 TUI 交互界面；安装器同时提供短别名 atag，效果完全一致。
```
atomic-agent
```
4导入其他智能体数据

若从别的智能体迁移，可导入技能、记忆、MCP 服务器、会话与定时任务，写入前会先做 dry-run 预览。
```
atomic-agent import claude-code
```
5选择模型运行设备

托管模式会自动挑选 GPU 后端，可查看设备列表后手动指定，或直接回退到 CPU 运行。
```
atomic-agent models devices
atomic-agent models use-device auto
```
6检查并更新版本

自更新仅在已安装的二进制上生效，开发检出需通过 git 更新；--check 只探测不安装。
```
atomic-agent update --check
```
7卸载（可选）

删除状态目录、二进制与别名、资源目录及 shell rc 中的 PATH 行，不可撤销，建议先预览。
```
atomic-agent uninstall --dry-run
```

关键配置

配置项	必填	说明	示例
`localModels.completionMaxTokens`	否	本地模型单次回复上限，对应 llama.cpp 的 n_predict，默认 8192，0 表示不限制	`8192`
`maxOutputTokens`	否	云服务商条目的单次输出上限；不设置时默认按模型自身最大值，不封顶	`64000`
`strictTools`	否	让服务商以严格模式约束工具 schema，仅对 OpenAI 兼容类型生效，默认关闭	`true`
`localModels.managed.tensorSplit`	否	多 GPU 层切分比例，按可见 GPU 顺序分配层数	`[3, 1]`

如何确认成功

执行 atomic-agent 后出现 TUI 交互界面即启动成功；更新完成后 TUI 会提示你重启。

常见问题

Q：安装后提示找不到命令怎么办？

A：安装器已把 PATH 行写入 shell rc 文件，重开终端或重新加载该配置即可；也可直接用短别名 atag 启动。

Q：机器没有独立显卡还能用吗？

A：可以。托管模式始终能启动，没有可用 GPU 驱动时自动回退 CPU；Linux 上安装 Vulkan 驱动可启用 GPU 卸载。

Q：Linux 下浏览器无法启动？

A：部分容器或特定内核会导致 Chromium 系沙箱失败，可用 --no-sandbox 参数启动 Chrome 后再使用浏览器工具。

Q：想彻底删除怎么操作？

A：运行 atomic-agent uninstall，它会列出待删内容并要求输入 uninstall 确认；可用 --dry-run 预览、--keep-data 保留数据。

Q：本地模型回复被截断？

A：调大 localModels.completionMaxTokens（默认 8192），或设为 0 取消上限，此时在停止符或上下文写满时结束。

注意事项

当前为开发者预览版，API、命令与配置仍在变动，需要稳定集成点时请固定版本。
托管本地模型仅面向 Linux x64 提供；arm64 平台需手动指向外部 llama-server。
浏览器二进制不随安装包提供，需自行准备 Chromium 系浏览器。
卸载不可撤销且不会上传任何数据，但会一并删除模型与记忆等状态目录。

核心亮点

真正本地运行，数据不出设备，隐私零泄露
支持超长上下文窗口，处理复杂任务不丢信息
工具调用规范，可自动化浏览器操作，实用性强

不足之处

文档/社区待观察
依赖本地硬件性能，低配设备可能运行吃力

适用场景

隐私敏感场景下的本地自动化助手
离线环境中的智能体任务处理
开发者本地测试和调试 AI 智能体

替代项目

OpenClaw、Hermes Agent、LocalAI

项目介绍

atomic-agent 是智能体领域的开源项目，由 AtomicBot-ai 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,545）位列前 30%，在智能体分类的 2,517 个项目里位列前 15%。

近 42 天，它的 GitHub 星标从 1,758 增加到 2,545，净增 787。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，本地优先，完全免费，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：隐私敏感场景下的本地自动化助手。同类可对比的替代方案包括 OpenClaw、Hermes Agent、LocalAI。

上一篇：open-codex-computer-use

下一篇：gini-agent