Production-grade multiservice Agent Development Kit
Project description
🤖 LiteLLM ADK (Agent Development Kit)
A production-grade, highly flexible multiservice framework for building AI agents. Swap models, API keys, and configurations dynamically while maintaining a robust structure for tool usage, complex memory persistence, and human oversight.
🌟 Key Features
- 🔌 Model Agnostic: Native support for 100+ LLMs (OpenAI, Anthropic, OCI Grok-3, Llama) via LiteLLM.
- 📊 Database Intelligence: Built-in
DatabaseAgent(NL2SQL) with adapters for MySQL, PostgreSQL, and MongoDB. - 🧠 Advanced Memory: Pluggable persistence via local JSON, MongoDB, or Vector stores (Chroma, PGVector).
- 🛡️ Human-in-the-Loop: Integrated
PolicyEngineandApprovalManagerfor safe tool execution with audit trails. - ⚡ Modern Async/Streaming: First-class support for
ainvokeand event-based streaming (astream). - 🔍 Observability: Structured logging and token tracking out of the box.
🚀 Quick Start
1. Installation
pip install litellm-adk
2. Basic Agent with Tools
import asyncio
from litellm_adk import LiteLLMAgent, tool, FileMemory
# Define a tool with zero boilerplate
@tool
def get_stock_price(symbol: str):
"""Fetches the current stock price."""
return {"symbol": symbol, "price": 150.0}
async def main():
# Initialize with persistent file memory
agent = LiteLLMAgent(
model="oci/xai.grok-3",
tools=[get_stock_price],
memory=FileMemory("history.json")
)
response = await agent.ainvoke("What is the price of AAPL?")
print(f"Agent: {response}")
await agent.aclose()
if __name__ == "__main__":
asyncio.run(main())
📊 High-Performance Database Agents
The ADK specializes in NL2SQL via the DatabaseAgent. It supports "Blind Summarization" for security—allowing the agent to talk about data without leaking PII into model logs.
from litellm_adk import DatabaseAgent
agent = DatabaseAgent(
db_url="mysql+pymysql://user:pass@localhost/analytics",
model="gpt-4o",
return_direct=True # Privacy: Summary to LLM, full data to your UI
)
📖 Documentation
Dive deeper into the components:
- 🤖 Agent Core: Logic, streaming, and failover.
- 📊 Database Integration: SQL, MySQL, and MongoDB.
- 🧠 Memory & Persistence: Storing state and history.
- 🛠️ Tools & HITL: Custom tools and Human-in-the-Loop policies.
🏗️ Project Structure
core/: Abstract base classes (Agent, Memory, Adapter).integrations/: Specific implementations (MySQL, MongoDB, ChromaDB).session/: State management for multi-user chat.observability/: Logging and telemetry.
📜 License
MIT © 2026 Aarumugapandi
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file litellm_adk-0.2.4.tar.gz.
File metadata
- Download URL: litellm_adk-0.2.4.tar.gz
- Upload date:
- Size: 41.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3527fda598be6db4d4357be3ddf93c8791f6893d7987e42da3096fb7d82c35aa
|
|
| MD5 |
eee3f4f3ac2d1dc93a2aef45eeaaeab2
|
|
| BLAKE2b-256 |
114c21ea6188cc9bf3a47cc589b4739e3aae6c0aeb3d7ae6e32601269cc44020
|
File details
Details for the file litellm_adk-0.2.4-py3-none-any.whl.
File metadata
- Download URL: litellm_adk-0.2.4-py3-none-any.whl
- Upload date:
- Size: 51.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
421895688c571ddcafa592d83b12e67fca0152b2e890d098b206300f49978eac
|
|
| MD5 |
6f90aa491b35ec566cf2457ca81bd068
|
|
| BLAKE2b-256 |
5fe367450d15aee4adecda27f089a43c153d2ef8b128507ea97f769d72815758
|