Atomic-Chat

环境要求

• macOS 桌面系统（提供 .dmg 安装包）或 Linux 桌面系统（提供 .AppImage）
• 使用源码方式运行需具备 git 与 make 命令行工具
• Linux 首次启动若提示 FUSE 缺失，需安装 fuse/libfuse2
• 本地运行模型需自备 GGUF 格式模型文件（README 指出 Linux 仅支持 GGUF）

安装与启动步骤

1. 1下载桌面安装包

   无需命令行，直接从 GitHub Releases 下载 macOS 版 .dmg（Atomic.Chat_2.0.0_universal.dmg）安装运行，也可访问官网 Getting Started 获取指引。

2. 2克隆源码仓库

   选择源码方式运行的第一步，把 Atomic-Chat 仓库克隆到本地并进入项目目录。

   git clone https://github.com/AtomicBot-ai/Atomic-Chat
   cd Atomic-Chat

   复制

3. 3一键开发启动

   make dev 会自动完成依赖安装、核心组件构建并启动应用，无需手动配置环境，是最推荐的开发运行方式。

   make dev

   复制

4. 4生产构建可选

   需要打包正式版本时执行 make build；make test 用于跑测试和 lint，make clean 用于清空环境重新开始。

   make build

   复制

5. 5Linux 运行 AppImage

   Linux 版是单文件自包含 .AppImage，无需安装器也无需 root，先加可执行权限再直接运行即可。

   chmod +x Atomic.Chat_*_amd64.AppImage
   ./Atomic.Chat_*_amd64.AppImage

   复制

6. 6补装 FUSE 依赖

   Linux 首次启动若提示 FUSE 相关问题，Debian/Ubuntu 执行该命令安装 fuse 与 libfuse2，Fedora 用 sudo dnf install fuse fuse-libs，装完重试。

   sudo apt install fuse libfuse2

   复制

如何确认成功

make dev 执行完后应用窗口自动弹出；Linux 运行 AppImage 后出现 Atomic Chat 界面即部署成功。

常见问题

注意事项

• README 未提供 Docker 或云端部署方式，项目定位是纯本地桌面应用，所有计算都在用户设备上完成。
• macOS 安装包为 universal 通用架构版本，Apple Silicon 可直接获得优化体验。
• Linux 版本只支持 GGUF 模型，选模型时注意格式。
• 遇到问题可通过 README 中的 Discord 社区或 GitHub Issues 反馈。