# Atomic Agents

> Atomic Agents is a lightweight, modular Python framework for building agentic AI applications
> as composable, schema-driven building blocks. Built on Instructor and Pydantic: every agent is
> a typed transformer from an input schema to an output schema, with full developer control and
> no hidden abstractions. Provider-agnostic (OpenAI, Anthropic, Groq, Gemini, Ollama, and more).

Key API facts: import from the top-level `atomic_agents` package (`AtomicAgent`, `AgentConfig`,
`BaseIOSchema`, `BaseTool`) and from `atomic_agents.context` (`ChatHistory`,
`SystemPromptGenerator`, `BaseDynamicContextProvider`). Agents are constructed as
`AtomicAgent[InputSchema, OutputSchema](config=AgentConfig(...))` with an Instructor-wrapped
client. Every `BaseIOSchema` subclass requires a docstring. Python 3.12+.

## Documentation

- [Quickstart guide](https://eigenwise.github.io/atomic-agents/guides/quickstart.html): first agent, providers, streaming
- [Tools guide](https://eigenwise.github.io/atomic-agents/guides/tools.html): BaseTool, Atomic Forge, MCP interop
- [Orchestration guide](https://eigenwise.github.io/atomic-agents/guides/orchestration.html): multi-agent patterns
- [Memory guide](https://eigenwise.github.io/atomic-agents/guides/memory.html): ChatHistory, persistence, custom backends
- [Hooks guide](https://eigenwise.github.io/atomic-agents/guides/hooks.html): telemetry, retries, error handling
- [API reference](https://eigenwise.github.io/atomic-agents/api/index.html): full API documentation

## Bundles

- [llms-full.txt](https://eigenwise.github.io/atomic-agents/llms-full.txt): complete documentation, framework source code, and all examples in one file
- [llms-docs.txt](https://eigenwise.github.io/atomic-agents/llms-docs.txt): documentation only
- [llms-source.txt](https://eigenwise.github.io/atomic-agents/llms-source.txt): framework source code only
- [llms-examples.txt](https://eigenwise.github.io/atomic-agents/llms-examples.txt): runnable example projects only

## Optional

- [GitHub repository](https://github.com/eigenwise/atomic-agents): source, issues, discussions
- [Agent skills](https://github.com/eigenwise/atomic-agents/tree/main/claude-plugin/atomic-agents): installable skills for coding assistants (`npx skills add eigenwise/atomic-agents`)
- [PyPI package](https://pypi.org/project/atomic-agents/): `pip install atomic-agents`