Build Autonomous AI Agents with MiMinions¶
The open-source framework for creating, deploying, and managing agentic AI systems at scale — built on pydantic-ai and OpenRouter.
Key Features¶
-
Autonomous Agents
Create AI agents that think, plan, and execute tasks independently through an async reasoning loop powered by pydantic-ai and OpenRouter.
-
Multi-Agent Systems
Build complex systems where multiple agents collaborate, share context, and coordinate to solve problems no single agent could.
-
Long-Term Memory
A three-tier memory system — session logs, workspace facts, and global insights — keeps agents context-aware across conversations.
-
MCP Integration
Load tools directly from Model Context Protocol servers and run them alongside your own custom Python functions.
-
Generic Tool System
Define a tool once and use it across LangChain, AutoGen, and AGNO without rewriting a thing.
-
Vector Search
SQLite-backed vector memory with semantic, keyword, and full-text search for fast, relevant retrieval.
Get Started with MiMinions¶
Build powerful autonomous AI agents that understand complex tasks, make decisions, and execute actions with minimal human intervention. Everything you need to create intelligent systems that scale — in a few lines of code.
Why choose MiMinions?¶
- Rapid development — get started in minutes with an intuitive API
- Production ready — built for scale with reliable, tested internals
- Flexible architecture — customise agents to fit your unique needs
- Open source — join the community and shape the future of agentic AI
Quick start¶
Install the framework:
Create your first agent:
import asyncio
from miminions.agent import create_minion
async def main():
agent = create_minion("MyAgent")
def add(a: int, b: int) -> int:
return a + b
agent.register_tool("add", "Add two numbers", add)
reply = await agent.run("What is 3 + 7?")
print(reply)
asyncio.run(main())
Then head to the Getting Started guide to go further.
Architecture¶
┌─────────────────────────────────────────────────────────────┐
│ CLI / Chat │
└─────────────────────────┬───────────────────────────────────┘
│
┌─────────────────────────▼───────────────────────────────────┐
│ Minion Agent │
│ (pydantic-ai + OpenRouter + MCP) │
└──────────┬──────────────┬───────────────────┬───────────────┘
│ │ │
┌──────▼──────┐ ┌─────▼──────┐ ┌─────────▼────────┐
│ Tools │ │ Memory │ │ Context Builder │
│ (Generic, │ │ (3-tier: │ │ (prompt assembly │
│ MCP, LLM) │ │ MD+SQLite) │ │ from workspace) │
└─────────────┘ └────────────┘ └──────────────────┘
Ready to build something amazing?¶
Join the developers building the future of autonomous AI.