← all repositories
Eigenwise/atomic-agents

Atomic Agents treats your LLM pipeline like actual software

It exists to replace autonomous LLM chaos with small, schema-validated Python components that you can test, chain, and reuse like ordinary software.

6.2k stars Python AgentsLLMOps · Eval
atomic-agents
Velocity · 7d
+2.6
★ / day
Trend
steady
star history

What it does

Atomic Agents is a lightweight Python framework that builds LLM applications by snapping together small, single-purpose components—agents, tools, and context providers—each bound by strict Pydantic input and output schemas. It sits on top of Instructor, turning LLM calls into typed, validated contracts rather than open-ended conversations. Every agent is essentially a function: a system prompt, a schema for what goes in, and a schema for what comes out.

The interesting bit

The framework treats prompt engineering like plumbing: you chain agents and tools by matching an agent’s output schema to another’s input schema, so components swap out without rewriting prompts. Runtime context is injected via pluggable Context Providers that feed live data straight into the system prompt, keeping the core agent definition static while the world around it changes.

Key highlights

  • Strict Pydantic schemas for every input and output, built on Instructor.
  • Chain agents by aligning schemas, making the pipeline modular and provider-agnostic.
  • Context Providers inject dynamic data into system prompts at runtime without touching agent logic.
  • Includes an Atomic Assembler CLI for downloading pre-built Tools (Agents and Pipelines are marked “soon”).
  • All orchestration is plain Python—no hidden DSL or YAML abstraction layers.

Caveats

  • The CLI currently only supports downloading Tools; Agents and Pipelines are listed as coming soon.
  • The README flags v1.x upgrades as requiring attention, but the specific breaking changes aren’t visible in the provided text.

Verdict

Use this if you need reliable, maintainable LLM integrations that behave more like a library than a lab experiment. If you want fully autonomous agents that invent their own goals, look elsewhere—the README explicitly pitches control over autonomy.

Frequently asked

What is Eigenwise/atomic-agents?
It exists to replace autonomous LLM chaos with small, schema-validated Python components that you can test, chain, and reuse like ordinary software.
Is atomic-agents open source?
Yes — Eigenwise/atomic-agents is open source, released under the MIT license.
What language is atomic-agents written in?
Eigenwise/atomic-agents is primarily written in Python.
How popular is atomic-agents?
Eigenwise/atomic-agents has 6.2k stars on GitHub and is currently holding steady.
Where can I find atomic-agents?
Eigenwise/atomic-agents is on GitHub at https://github.com/Eigenwise/atomic-agents.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.