Skip to content

Releases: hexcreator/ab

v0.1.0 - Initial Release

13 Dec 04:05
@hexcreator hexcreator
v0.1.0
6abc077

Choose a tag to compare

View all tags
v0.1.0 - Initial Release Latest
Latest

🎉 First Open Source Release!

Atomic Blueprint (ab) is now open source! This is the initial release of the App-Dev Agent Memory Kernel.

✨ What's New

Core Features

  • Structured Memory System: Cards, Buffers, and Moments for organized memory storage
  • RECALL:SHAPE: Efficient, bounded retrieval with shape-based queries
  • Council of Selves: Multiple internal agents (Architect, Executor, Historian, FeaturePlanner) providing ranked suggestions
  • Zero Setup: Works out of the box with SQLite (no database server needed!)
  • PostgreSQL Support: Optional production database support
  • Project Scoping: Isolated memory per project/repo
  • Image Storage: Flexible image storage with metadata extraction (optional)
  • Integration Ready: Hooks for Cursor IDE and generic agent systems

Architecture Highlights

  • Async-first design with SQLAlchemy async
  • Database-agnostic schema (SQLite and PostgreSQL)
  • Shape-based retrieval system
  • Strength-based card ranking with decay/boost
  • Extensible shape and self agent system

🚀 Getting Started

# Install with uv (recommended)
uv pip install ab

# Or with pip
pip install ab
import asyncio
from ab import ABClient
from uuid import uuid4

async def main():
    async with ABClient(project_id=uuid4()) as client:
        card_id = await client.store_awareness(
            prompt="User wants to add authentication",
            files=["src/auth.py"],
            diffs="Added User model"
        )
        context = await client.recall_shape("architecture_context")
        result = await client.run_council(card_id)
        print(f"Winner: {result.winner[0] if result.winner else 'None'}")

asyncio.run(main())

📦 Installation Options

  • Basic: pip install ab (SQLite only)
  • With PostgreSQL: pip install ab[postgresql]
  • Full: pip install ab[full] (PostgreSQL + migrations)

📚 Documentation

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

📄 License

MIT License - see LICENSE for details.

Full Changelog: initial...v0.1.0

Assets 2
Loading