Skip to content

Latest commit

ย 

History

24 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Atomic Agents

The open source alternative to Amazon Bedrock AgentCore

90% cheaper โ€ข Deploy anywhere โ€ข No vendor lock-in

[โญ Star this repo] [๐Ÿ› Report Bug] [๐Ÿ’ก Request Feature]


๐ŸŽฏ Why Atomic Agents?

Amazon just launched Bedrock AgentCore. It's great, but:

  • โŒ Expensive (standard LLM costs + AWS markup)
  • โŒ AWS lock-in (can't deploy elsewhere)
  • โŒ Closed source (can't see or modify code)

Atomic Agents solves all three:

  • โœ… 90% cheaper via TDLN compression
  • โœ… Deploy anywhere (AWS, GCP, Azure, self-hosted)
  • โœ… Open source (MIT license)

Plus features Bedrock doesn't have:

  • ๐Ÿ”’ Structural governance (policy gates)
  • ๐Ÿ“œ Cryptographic audit trail (immutable ledger)
  • ๐Ÿ“Š Complete dashboard (included, no extra setup)
  • ๐Ÿ’ฐ Explicit cost modes (mechanic vs genius)

๐Ÿš€ Quick Start

Option 1: Docker (Easiest)

docker pull danvoulez/atomic-agents
docker run -p 3000:3000 danvoulez/atomic-agents

Option 2: From Source

git clone https://github.com/danvoulez/Atomic-Agents.git
cd Atomic-Agents
npm install
npm run dev

Open http://localhost:3000


๐Ÿ’ก Core Concepts

TDLN (Translation-Deterministic Language Network)

Compresses natural language โ†’ structured format โ†’ 90% token savings

Example: Before: "Please analyze this auth module and refactor..." (1500 tokens) After: task:analyze target:auth.ts action:refactor (150 tokens) โ†’ 90% reduction = 10x cheaper!

Policy Gates

Structural governance that's impossible to bypass:

{
  mode: "mechanic",
  budget: { maxSteps: 20, maxCostCents: 50 },
  tools: ["read_file", "run_tests"], // Only safe tools
  enforced: true // Cannot be overridden
}

Ledger

Append-only, cryptographically verified audit trail: Every decision, tool call, and result is recorded. Cannot be altered or deleted. "If it's not in the ledger, it didn't happen."


๐Ÿ“Š Cost Comparison

Building a coding agent that processes 1000 tasks/month:

Provider Tokens/Task Cost/Task Monthly Cost
Bedrock AgentCore 15,000 $0.50 $500
Atomic Agents 1,500 $0.05 $50
Savings 90% less 90% less $450/month

At scale (10k tasks/month): Save $4,500/month!


๐Ÿ—๏ธ Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ User Interface (Web) โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Coordinator (TDLN) โ”‚ โ”‚ โ€ข Compresses input (90% reduction) โ”‚ โ”‚ โ€ข Routes to appropriate agent โ”‚ โ”‚ โ€ข Enforces policy gates โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Mechanic Agent โ”‚ โ”‚ Genius Agentโ”‚ โ”‚ โ€ข Fast, cheap โ”‚ โ”‚ โ€ข Exploratoryโ”‚ โ”‚ โ€ข Strict rules โ”‚ โ”‚ โ€ข More tools โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Ledger (Truth) โ”‚ โ”‚ โ€ข Immutable event log โ”‚ โ”‚ โ€ข Cryptographic hashes โ”‚ โ”‚ โ€ข Complete audit trail โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜


๐ŸŽฎ Features

โœ… Multi-Agent System

  • Coordinator: Routes tasks intelligently
  • Planner: Breaks down complex goals
  • Builder: Executes code changes
  • Tester: Runs tests and validates
  • Evaluator: Assesses quality

โœ… Cost Optimization

  • TDLN Compression: 90% token reduction
  • Budget Enforcement: Hard limits per job
  • Mode Selection: Mechanic (cheap) vs Genius (expensive)
  • Tool Optimization: Read tools cheaper than write

โœ… Governance & Safety

  • Policy Gates: Structural rules enforcement
  • Ledger: Immutable audit trail
  • Tool Separation: Read vs write clearly marked
  • Budget Caps: Cannot exceed limits

โœ… Observability

  • Complete Dashboard: Real-time monitoring
  • Event Timeline: See every decision
  • Cost Tracking: Per-job breakdown
  • Quality Scores: Automatic evaluation

๐Ÿ“– Documentation


๐ŸŽฏ Roadmap

โœ… v0.1 (Current)

  • Core agent system
  • TDLN compression
  • Policy gates
  • Ledger
  • Basic dashboard

๐Ÿšง v0.2 (Next)

  • WebSocket support (real-time)
  • Docker images
  • Kubernetes manifests
  • Enhanced evaluation
  • More built-in tools

๐Ÿ“… v1.0 (Future)

  • Multi-model support
  • Distributed execution
  • Advanced memory system
  • Plugin ecosystem
  • Hosted option

๐Ÿค Contributing

We welcome contributions! See CONTRIBUTING.md

Areas we need help:

  • ๐Ÿ“ Documentation improvements
  • ๐Ÿงช More test coverage
  • ๐Ÿ”ง New tools/integrations
  • ๐ŸŽจ UI/UX enhancements
  • ๐ŸŒ Translations

๐Ÿ’ฌ Community


๐Ÿ“œ License

MIT License - see LICENSE


๐Ÿ™ Acknowledgments

Built with inspiration from:

  • Amazon Bedrock AgentCore (validation of the concept)
  • Model Context Protocol (MCP)
  • OpenAI Agents
  • LangChain

Special thanks to everyone who helped during 18 months of development!


โš ๏ธ Disclaimer

This is independent open source software. Not affiliated with Amazon or AWS. "Bedrock AgentCore" is a trademark of Amazon Web Services.


Made with โค๏ธ by @danvoulez

If you find this useful, please โญ star the repo!

  1. LICENSE MIT License

Copyright (c) 2024 Dan Voulez

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages