abi-core-ai 0.1.0b4

Agent-Based Infrastructure Core - Runtime and CLI

ABI-Core 🤖

ABI-Core-AI — The foundation for building Agent-Based Infrastructure (ABI) — a new architectural paradigm where intelligent agents collaborate through semantic context, policy-driven governance, and modular orchestration.

Agent-Based Infrastructure Core — A comprehensive framework for building, deploying, and managing AI agent systems with semantic layers, orchestration, and security policies.

---

🧭 Core Philosophy

ABI-Core is built on three fundamental principles:

1. Semantic Interoperability — Agents must share meaning, not just data.
2. Distributed Intelligence — No single model owns the truth; collaboration is the substrate.
3. Governed Autonomy — Security and compliance must evolve as fast as intelligence itself.

⚠️ Beta Release: This is a beta version. APIs may change and some features are experimental.

---

🚀 Quick Start

Installation

pip install abi-core-ai

Create Your First Project

# Create a new ABI project
abi-core-ai create project my-ai-system

# Navigate to your project
cd my-ai-system

# Create an agent
abi-core-ai create agent my-agent

# Run your project
docker-compose up

---

🎯 What is ABI-Core?

ABI-Core-AI is a production-ready framework for building Agent-Based Infrastructure systems that combine:

• 🤖 AI Agents — LangChain-powered agents with A2A (Agent-to-Agent) communication
• 🧠 Semantic Layer — Vector embeddings and distributed knowledge management
• 🔒 Security — OPA-based policy enforcement and access control
• 🌐 Web Interfaces — FastAPI-based REST APIs and real-time dashboards
• 📦 Containerization — Docker-ready deployments with orchestration

---

🏗️ Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   AI Agents     │◄──►│ Semantic Layer  │◄──►│   Guardian      │
│                 │    │                 │    │   Security      │
│ • LangChain     │    │ • Vector DB     │    │ • OPA Policies  │
│ • A2A Protocol  │    │ • Embeddings    │    │ • Access Control│
│ • Custom Logic  │    │ • Knowledge     │    │ • Monitoring    │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         └───────────────────────┼───────────────────────┘
                                 │
                    ┌─────────────────┐
                    │  Web Interface  │
                    │                 │
                    │ • FastAPI       │
                    │ • Real-time UI  │
                    │ • Monitoring    │
                    └─────────────────┘

---

📋 Features

🤖 Agent System

• Multi-Agent Architecture — Create specialized agents for different tasks
• A2A Communication — Agents can communicate and collaborate
• LangChain Integration — Leverage the full LangChain ecosystem
• Custom Tools — Extend agents with domain-specific capabilities

🧠 Semantic Layer

• Vector Storage — Weaviate integration for semantic search
• Embedding Management — Automatic text-to-vector conversion
• Knowledge Graphs — NetworkX-based relationship modeling
• Context Awareness — Agents understand semantic relationships

🔒 Security & Governance

• Policy Engine — Open Policy Agent (OPA) integration
• Access Control — Fine-grained permissions and roles
• Audit Logging — Complete activity tracking
• Compliance — Built-in security best practices

🌐 Web & APIs

• REST APIs — FastAPI-based service endpoints
• Real-time Updates — WebSocket support for live data
• Admin Dashboard — Monitor and manage your agent system
• Custom UIs — Build domain-specific interfaces

---

🛠️ CLI Commands

Project Management

abi-core-ai create project <name>
abi-core-ai status
abi-core-ai run

Agent Development

abi-core-ai create agent <name>
abi-core-ai info agents
abi-core-ai agent <name> status

Services

abi-core-ai create service semantic-layer
abi-core-ai create service guardian

---

📁 Project Structure

When you create a new project, you get:

my-project/
├── agents/                 # Your AI agents
│   └── my-agent/
│       ├── agent.py        # Agent implementation
│       ├── main.py         # Entry point
│       └── models.py       # Data models
├── services/               # Supporting services
│   ├── semantic-layer/     # Vector DB & embeddings
│   └── guardian/           # Security & policies
├── config/                 # Configuration
│   └── config.py
├── docker-compose.yml      # Container orchestration
└── README.md               # Project documentation

---

🔧 Configuration

ABI-Core uses environment variables and YAML configuration files:

# .abi/runtime.yaml
agents:
  my-agent:
    model: "llama3.2:3b"
    port: 8000
    
semantic_layer:
  provider: "weaviate"
  host: "localhost:8080"
  
security:
  opa_enabled: true
  policies_path: "./policies"

---

🚀 Deployment

Docker (Recommended)

docker-compose up --build
docker-compose up --scale my-agent=3

Kubernetes

abi-core-ai deploy kubernetes
kubectl apply -f ./k8s/

---

🧪 Examples

Simple Agent

from abi_core_ai.agent.agent import AbiAgent
from abi_core_ai.common.utils import abi_logging

class MyAgent(AbiAgent):
    def __init__(self):
        super().__init__(
            agent_name='my-agent',
            description='A helpful AI assistant'
        )
    
    async def stream(self, query: str, context_id: str, task_id: str):
        abi_logging(f"Processing: {query}")
        response = await self.llm.ainvoke(query)
        yield {
            'content': response.content,
            'response_type': 'text',
            'is_task_completed': True
        }

Agent Communication

await self.send_message(
    target_agent="agent-b",
    message="Process this data",
    data={"items": [1, 2, 3]}
)

---

📚 Documentation

• Getting Started Guide
• Agent Development
• Semantic Layer
• Security & Policies
• API Reference

---

🤝 Contributing

We welcome contributions! This is a beta release, so your feedback is especially valuable.

Development Setup

git clone https://github.com/Joselo-zn/abi-core-ai
cd abi-core-ai
uv sync --dev

Running Tests

uv run pytest

---

📄 License

Apache 2.0 License — see LICENSE for details.

---

🆘 Support

• Issues — GitHub Issues
• Discussions — GitHub Discussions
• Email — [e-mail]

---

🗺️ Roadmap

Milestone	Description	Status
v0.2.0	Enhanced agent orchestration	🔜 In progress
v0.3.0	Advanced semantic search	🧠 Planned
v0.4.0	Multi-cloud deployment	🧩 Planned
v1.0.0	Production-ready stable release	🏁 Target Q3 2026

---

Built with ❤️ by José Luis Martínez
Creator of ABI (Agent-Based Infrastructure) — redefining how intelligent systems interconnect.

✨ From Curiosity to Creation: A Personal Note

I first saw a computer in 1995. My dad had received a Windows 3.11 machine as payment for a job. I was fascinated. At the time, I wanted to study robotics — but when I touched that machine, everything changed.

I didn't understand what the Internet was, and I had no idea where to go… but even in that confusion, I felt something big. When I wrote my first Visual C++ program in 1999, I felt like a hacker. When I built my first web page, full of GIFs, I was flying.

Nobody taught me. I just read manuals. And now, years later, that journey continues — not just as a coder, but as the creator of ABI. This is for the kids like me, then and now.