hybro

The open-source agent interoperability platform.

⭐ Star this repo to support the growing Hybro open-source community!

Hybro AI is an open-source, hybrid multi-agent platform built for seamless agent interoperability. It serves as the core orchestration engine powering the Hybro Agent Network—enabling local and remote AI agents to communicate, collaborate, and execute complex workflows.

Overview

Hybro AI allows developers and teams to deploy, coordinate, and inspect clusters of autonomous AI agents. Powered by an async FastAPI backend and an interactive Next.js dashboard, Hybro provides real-time agent visualization, execution room management, and protocol-agnostic message routing via the Agent2Agent (A2A) standard.

Key Features

• Hybrid Agent Execution: Seamlessly connect and orchestrate local on-device agents and remote cloud-hosted services.
• Native Agent Interoperability: Built around the open Agent2Agent (A2A) protocol for standardized inter-agent communication.
• Multi-Agent Execution Rooms: Group specialized agents in dedicated execution rooms to solve multi-step tasks collaboratively.
• Real-Time Streaming & Inspection: Live SSE message streaming, multi-agent turn timelines, and an interactive A2A Agent Inspector for testing agent capabilities.
• Zero-Config Developer Mode: Start the frontend and backend instantly out of the box with zero required external API keys.

Getting Started

Prerequisites

• Docker and Docker Compose
• Node.js 20.19+ (if running the frontend outside of Docker)
• Python 3.12+ and MongoDB 4.2+ (if running the backend outside of Docker; Docker Compose uses MongoDB 7.0)

Quick Start (Docker)

The easiest way to get started is using the automated installation script, which will clone the repository, set up the environment, and spin up the Docker containers.

curl -fsSL https://raw.githubusercontent.com/hybroai/hybro/main/install.sh | sh

Alternatively, you can manually clone and run:

git clone https://github.com/hybroai/hybro.git
cd hybro
docker compose up -d --build

• Hybro App: http://localhost:3000
• API Server: http://localhost:8000

Architecture

This repository is the source of truth for the product. Its frontend and backend
are the in-repository frontend/ and backend/ directories used by Docker
Compose and CI.

The repository is split into these primary components:

• backend/: A FastAPI orchestration engine using MongoDB for persistence and optional Redis services for cross-process coordination.
• frontend/: A Next.js 16 (Turbopack) application for chat, agent discovery, agent management, Hub status, and inspection.
• default_agents/: A collection of ready-to-use A2A agents, each running as its own container, plus a one-shot registrar that registers them with the backend on startup.

API key

The default agents use the same OPENAI_API_KEY as the backend. Set it in both backend/.env and default_agents/.env. Agents register regardless, but calls will fail until a valid key is provided.

Contributing

We welcome contributions from the community! Whether you are fixing a bug, adding a feature, or improving documentation, please feel free to open a pull request.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

Apache License 2.0