Atomic Agents

What is Atomic Agents?

The Atomic Agents framework is designed around the concept of atomicity to be an extremely lightweight and modular framework for building Agentic AI pipelines and applications without sacrificing developer experience and maintainability.

Think of it like building AI applications with LEGO blocks - each component (agent, tool, context provider) is:

• Single-purpose: Does one thing well
• Reusable: Can be used in multiple pipelines
• Composable: Easily combines with other components
• Predictable: Produces consistent, reliable outputs

Built on Instructor and Pydantic, it enables you to create AI applications with the same software engineering principles you already know and love.

NEW: Join our community on Discord at discord.gg/J3W9b5AZJR and our official subreddit at /r/AtomicAgents!

Free and MIT-licensed. If Atomic Agents saves you time, sponsoring on GitHub or buying me a coffee genuinely helps me keep building and maintaining it. More in Support.

Table of Contents

• Atomic Agents
  • What is Atomic Agents?
  • Table of Contents
  • Getting Started
    • Installation
    • Quick Example
  • Why Atomic Agents?
  • Core Concepts
    • Anatomy of an Agent
    • Context Providers
    • Chaining Schemas and Agents
  • Examples & Documentation
    • Quickstart Examples
    • Complete Examples
  • AI-Assisted Development
    • Project instructions (Cursor, Windsurf, Cline, Continue, and Aider)
    • Agent skills (Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, ...)

Getting Started

Installation

To install Atomic Agents, you can use pip:

pip install atomic-agents

Make sure you also install the provider you want to use. Provider SDKs are available as instructor extras:

pip install instructor[groq]        # for Groq
pip install instructor[anthropic]   # for Anthropic
pip install instructor[google-genai] # for Gemini

OpenAI is included by default. For a full list of supported providers, see the Instructor docs.

This also installs the CLI Atomic Assembler, which can be used to download Tools (and soon also Agents and Pipelines).

Quick Example

Here's a quick snippet demonstrating how easy it is to create a powerful agent with Atomic Agents:

This is the beginning of the README. Read the rest at the original. Read the full README ↗