unisonai 0.4

UnisonAI Multi-Agent Framework provides a flexible, light-weight experience and extensible environment for creating and coordinating multiple AI agents.

UnisonAI

---

UnisonAI is a flexible Python framework to build and manage multiple AI agents—either solo or in clans. Each agent is powered by the LLM of your choice, with agent-to-agent (A2A) communication capabilities.

✨ Key Features

• 🔗 Multi-LLM Support: OpenAI, Grok, Gemini, Cohere, Anthropic, and more

• 🧩 Modular & Extensible: Add your own tools, logic, and models

• 🤖 Single or Multi-Agent: Solo agents or collaborative Clan agents

• ⛨️ Error Handling: Built-in retries and format repairs

• 📃 Clear Docs & Examples: Easy to start and extend

• ⚡ Production Ready: Ideal for real-world automation & chatbots

---

🚀 Installation

pip install unisonai

Requires Python >=3.10 and <3.13

---

🧠 Core Concepts

Single_Agent

Run focused tasks with isolated agents using any LLM and tools.

Agent (for Clans)

A specialized agent that communicates and collaborates with others.

Clan

A group of agents working together with a manager and a shared goal.

Tool System

Add your own pluggable tools with parameters and logic.

---

🔧 Usage Example (Single Agent)

from unisonai import Single_Agent

from unisonai.llms import Gemini

from unisonai.tools.websearch import WebSearchTool

from unisonai import config



config.set_api_key("gemini", "your-api-key")



agent = Single_Agent(

  llm=Gemini(model="gemini-2.0-flash"),

  identity="Web Explorer",

  description="Agent to fetch stock prices",

  tools=[WebSearchTool],

  history_folder="history",

  output_file="output.txt"

)



agent.unleash(task="Get the current price of Apple stocks")

---

🗺 Usage Example (Clan Agent)

from unisonai import Agent, Clan

from unisonai.llms import Gemini

from unisonai.tools.websearch import WebSearchTool

from unisonai import config



config.set_api_key("gemini", "your-api-key")



planner = Agent(...)  # Define your clan leader agent



web_agent = Agent(...)

time_agent = Agent(...)



clan = Clan(

  clan_name="Travel Experts",

  manager=planner,

  members=[web_agent, time_agent],

  shared_instruction="Plan a 7-day budget trip in India",

  goal="Create an itinerary under 10,000 INR",

  history_folder="trip_history",

  output_file="trip_plan.txt"

)



clan.unleash()

---

🔑 API Key Setup

from unisonai import config

config.set_api_key("gemini", "your-gemini-key")

config.set_api_key("openai", "your-openai-key")

You can also use environment variables:

export GEMINI_API_KEY="your-key"

---

❓ FAQ

What is UnisonAI?

A multi-agent AI framework using your favorite LLMs.

Why Clans?

Break tasks into parts and assign agents to solve each collaboratively.

Can I use custom models/tools?

Yes! Just extend the BaseLLM or BaseTool classes.

Where are logs stored?

In the folder you define using history_folder.

What can I build?

Chatbots, planners, assistants, automation systems, and more.

---

👥 Contributors & License

• Lead Developer: @E5Anant

• Contributors: @AnonymousCoderArtist, @OEvortex

License: Apache 2.0

GitHub: https://github.com/UnisonAIInc/UnisonAI

---

UnisonAI — Orchestrate the Future of Multi-Agent AI