# ABI-Core Documentation

Welcome to the **ABI-Core** documentation! ABI-Core is a comprehensive framework for building, deploying, and managing AI agent systems with semantic layers, orchestration, and security policies.

```{toctree}
:maxdepth: 2
:caption: Getting Started

getting-started/installation
getting-started/quickstart
getting-started/concepts
```

```{toctree}
:maxdepth: 2
:caption: User Guide

user-guide/models
user-guide/complete-example
user-guide/agent-development
user-guide/semantic-enrichment
user-guide/extending-semantic-layer
user-guide/policy-development
user-guide/cli-reference
user-guide/troubleshooting
```

```{toctree}
:maxdepth: 2
:caption: API Reference

api/common-library
api/semantic-tools
```

```{toctree}
:maxdepth: 2
:caption: Architecture & Design

architecture
agent_protocols
gobernance
```

```{toctree}
:maxdepth: 1
:caption: Additional Resources

faq
changelog
roadmap
```

## What is ABI-Core?

**ABI-Core** (Agent-Based Infrastructure Core) is a production-ready framework that combines:

- 🤖 **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

## Quick Links

::::{grid} 2
:gutter: 3

:::{grid-item-card} 🚀 Quick Start
:link: getting-started/quickstart
:link-type: doc

Get up and running with ABI-Core in minutes
:::

:::{grid-item-card} 📚 User Guide
:link: user-guide/models
:link-type: doc

Learn how to build agent systems
:::

:::{grid-item-card} 🏗️ Architecture
:link: architecture
:link-type: doc

Understand the system design
:::

:::{grid-item-card} 🔧 API Reference
:link: api/common-library
:link-type: doc

Detailed API documentation
:::

::::

## Features

### Multi-Agent Architecture
Create specialized agents for different tasks with built-in A2A communication protocol.

### Semantic Discovery
MCP-based agent finding and routing with vector storage for semantic search.

### Security & Governance
Open Policy Agent (OPA) integration with fine-grained permissions and audit logging.

### Production Ready
Docker-ready deployments with health checks, monitoring, and scalability.

## Community

- **GitHub**: [github.com/Joselo-zn/abi-core](https://github.com/Joselo-zn/abi-core)
- **Issues**: [Report bugs or request features](https://github.com/Joselo-zn/abi-core/issues)
- **Discussions**: [Join the conversation](https://github.com/Joselo-zn/abi-core/discussions)

## License

ABI-Core is released under the Apache 2.0 License. See [LICENSE](https://github.com/Joselo-zn/abi-core/blob/main/LICENSE) for details.
