Atomic Agent
A local-first AI agent that runs on your machine, with local or cloud models.
Drives your browser, edits files, runs approved commands, and remembers context across sessions. Open source, running on our TurboQuant llama.cpp so long sessions with small local models fit in less memory.
Quick Install · Uninstall · Benchmarks · Why Local-First · Ways to Use It · Docs
A local-first AI agent that runs the control loop and all state on your machine. It works across your machine: browse the web, read and edit files, run approved shell commands, inspect documents, remember context across sessions, schedule follow-ups, and call external tools over MCP. Run it on a local model, a cloud model, or both at once in Fusion mode, where one model plans and a pool of workers executes. Embed it in your own apps over HTTP or a Tauri sidecar. llama.cpp first, so small quantized models stay useful for long, multi-step work on consumer hardware.
Quick Install
macOS / Linux:
curl -fsSL https://atomicagent.io/install | sh
Windows (PowerShell):
irm https://atomicagent.io/install.ps1 | iex
The installer downloads the release archive, verifies the checksum, and installs the CLI plus support assets (grammars/, native prebuilds, and bundled ripgrep). Atomic Agent updates itself in place; after an update the TUI prompts you to restart. Outside the TUI, run atomic-agent update (or atag update) to check for a newer release and re-run the installer in place; atomic-agent update --check probes without installing, and --version <tag> pins a specific release. Only the installed binary can self-update; a dev checkout updates via git, and a Linux package (below) updates with the package manager.
Linux packages
On Debian, Ubuntu, Fedora, RHEL-compatible systems and Arch, Atomic Agent also comes as a package, and the package manager then updates it with the rest of the system. A package carries the same release bundle as the installer, under /usr/lib/atomic-agent, with atomic-agent and atag in /usr/bin. The repository and the rpm packages are signed with the Atomic Chat packages key in packaging/atomic-chat.asc, fingerprint 1047 F119 58C6 442D D472 E497 E4C3 D361 FB7F F123.
Debian, Ubuntu (x86-64, arm64):
curl -fsSL https://atomic-agent-packages.fsn1.your-objectstorage.com/atomic-chat.gpg | sudo tee /usr/share/keyrings/atomic-chat.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/atomic-chat.gpg] https://atomic-agent-packages.fsn1.your-objectstorage.com/deb stable main" \
| sudo tee /etc/apt/sources.list.d/atomic-agent.list
sudo apt update && sudo apt install atomic-agent
Fedora, RHEL, Rocky, Alma (x86-64, aarch64):
sudo curl -fsSL -o /etc/yum.repos.d/atomic-agent.repo https://atomic-agent-packages.fsn1.your-objectstorage.com/rpm/atomic-agent.repo
sudo dnf install atomic-agent
Arch Linux: yay -S atomic-agent-bin, or any other AUR helper.
Updates come with sudo apt upgrade, sudo dnf upgrade or yay -Syu; on a packaged install atomic-agent update refuses and names the command to use, and the TUI does not offer its in-app update. A copy left by install.sh in ~/.local/bin runs ahead of the package on the usual PATH and keeps its own updates; atomic-agent update names both copies when that happens, and removing the copy hands the command to the package. sudo apt remove atomic-agent, sudo dnf remove atomic-agent or sudo pacman -R atomic-agent-bin removes the program and leaves your data; atomic-agent uninstall then lists only the data. The repository keeps the last ten releases; older ones are on the releases page as .deb and .rpm files. A package states the glibc its binary needs (2.34 today: Debian 12, Ubuntu 22.04, RHEL 9 and newer), and the package manager refuses where the system's is older.
Desktop app
The desktop app is in the same repository as atomic-agent-desktop (on Arch atomic-agent-desktop-bin). It has releases of its own (desktop-vX.Y.Z), carries its own copy of the agent under /opt/Atomic Agent and leaves a packaged or installed atomic-agent alone, so the two can be installed side by side. Once installed it is in the applications menu, and atomic-agent-desktop starts it from a terminal.
Debian, Ubuntu (x86-64, arm64):
This is the beginning of the README. Read the rest at the original. Read the full README ↗
