Atomic Agent
Atomic Agent is a local-first AI agent that runs on your machine, driving your browser, editing files, running approved shell commands, and remembering context across sessions. It solves the problem of costly and slow agent loops by keeping state local and optimizing for small quantized models. It is for developers who want a private, controllable AI assistant for desktop automation and development tasks.
✨ Key features
- Local-first control loop and state on your machine.
- Drives browser, filesystem, shell, and desktop via tools.
- Memory with profile, notes, lessons, procedures, and voting.
- Supports local llama.cpp and cloud providers (OpenAI-compatible, OpenRouter, etc.).
- MCP server integration for external tools.
- TUI and CLI interfaces with approvals and traces.
🎯 Use cases
- Automate web browsing and form filling tasks.
- Edit and manage files across projects.
- Run approved shell commands for system administration.
- Build custom agents embedded in apps via HTTP or Tauri sidecar.
- Schedule tasks and receive Telegram notifications.
📦 Installation
🧰 Requirements: Runs on macOS (Apple Silicon), Linux x64/arm64, and Windows x64. Requires a local model via llama.cpp or a configured cloud provider API key.
curl -fsSL https://atomicagent.io/install | sh
Windows (PowerShell):
irm https://atomicagent.io/install.ps1 | iex
🚀 Usage
atomic-agent
Or use the alias:
atag
⚠️ Good to know
Developer preview: APIs, commands, config, and behavior are still moving; pin a release for stable integration.
❓ FAQ
How do I update Atomic Agent?
Run atomic-agent update (or atag update) to check for a newer release and re-run the installer in place. Use --check to probe without installing, and --version <tag> to pin a specific release.
Can I import data from other agents?
Yes, on first run or via /import in the TUI or atomic-agent import <hermes|openclaw|claude-code|codex> from the shell, you can bring over skills, memory, MCP servers, sessions, cron jobs, and provider keys.
How do I uninstall Atomic Agent completely?
Run atomic-agent uninstall to remove everything, including state directory, binary, alias, and PATH line. It prints what will be deleted and asks for confirmation. Use --dry-run to preview, --keep-data to keep data, and --yes to skip the prompt.
What models does Atomic Agent support?
It defaults to local llama-server with curated quantized models, but also supports OpenAI-compatible, OpenRouter, AI/ML API, and Gemini providers. You can also use your existing Claude Code and OpenAI Codex subscriptions.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.