Metadata-Version: 2.4
Name: bat-adk
Version: 2025.12
Summary: Software Development Kit for building AI Agents in BubbleRAN MX-PDK and MX-AI
Author-email: Andrea LEONE <andrea.leone@bubbleran.com>
Project-URL: Homepage, https://bubbleran.com/
Project-URL: Repository, https://github.com/bubbleran/bat
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: a2a-sdk>=0.3.20
Requires-Dist: a2a-sdk[http-server]
Requires-Dist: httpx>=0.28.1
Requires-Dist: langchain>=0.3.24
Requires-Dist: langchain-mcp-adapters<0.2.0,>=0.1.13
Requires-Dist: langchain-nvidia-ai-endpoints>=0.3.9
Requires-Dist: langchain-openai>=0.3.14
Requires-Dist: langchain-ollama>=0.3.3
Requires-Dist: langgraph>=1.0.0
Requires-Dist: mcp[cli]>=1.17.0
Requires-Dist: pydantic>=2.10.6
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: uvicorn>=0.37.0

# BubbleRAN Agentic Toolkit - Agent Development Kit (ADK)

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](../LICENSE)
[![PyPI version](https://img.shields.io/pypi/v/bat-adk)](https://pypi.org/project/bat-adk/)

The **BAT-ADK** is a Python-based Software Development Kit designed to simplify the development, deployment, and integration of AI Agents within the BubbleRAN architecture.
This repository includes the ADK framework ([BubbleRAN Software License](https://bubbleran.com/resources/files/BubbleRAN_Licence-Agreement-1.3.pdf)).

## Key Features
- 🛠️ Easy-to-use Python SDK for developing AI Agents
- 🔗 Integrates the [LangGraph](https://pypi.org/project/langgraph/) library with the [A2A SDK](https://pypi.org/project/a2a-sdk/) and [MCP SDK]() for building AI Agents beyond POCs (ready for production)
- ☁️ Ready for Cloud-Native deployment with BubbleRAN [MX-AI](https://bubbleran.com/products/mx-ai/)
- 🧩 Prebuilt Agentic Workflow (e.g. ReAct, A2A Communication)

## Getting Started

### Prerequisites
- Python 3.12+
- `uv` (recommended) or `pip`

## Installation

### Using `uv`
```bash
uv add bat-adk
```

### Using `pip`
```bash
pip install bat-adk
```

## Documentation

The BAT-ADK uses [`pydoc-markdown`](https://pydoc-markdown.readthedocs.io/) to generate API documentation directly from Python docstrings.

### Generating the Documentation

To build the documentation locally, run:

```bash
uv run pydoc-markdown
```

The generated documentation will be available at `adk/build/docs/content/bat-adk`
