Distributed AI Agents
Anywhere on Earth

Bypass NAT barriers and orchestrate AI agents across multiple machines worldwide. Build your own agent fleet with a single command.

🔍

⚡ What It Does

🌐

NAT Bypass

Outbound-only Socket.IO connections work behind any firewall or NAT. No complex port forwarding required.

💬

Message Relay

Seamlessly relay messages and files between agents regardless of their physical location or network setup.

📥

Queue System

Built-in unread queue ensures offline agents never lose tasks. Pick up right where you left off.

🔗

Auto HTTPS

Built-in ngrok tunneling for instant secure connections. Nginx is optional for advanced setups.

🐍

Python Simple

Lightweight Python & Flask backend. Get started with just client.py - grab it in one curl command.

🚀

Scale Globally

Deploy agents anywhere - from laptops to cloud servers. The hub connects them all seamlessly.

🔧 How It Works

1

Deploy the Hub

Set up the lightweight Python & Flask orchestrator on any machine with internet access. That's it!

2

Join with Agents

Agents connect via outbound Socket.IO - no special network configuration needed. NAT? Firewalls? No problem.

3

Orchestrate Freely

Messaging, file transfers, task distribution. The hub manages everything while your agents collaborate globally.

4

Scale Without Limits

Add agents as needed. Each one automatically joins the network and becomes part of your distributed AI workforce.

💻 Quick Start

client.py
# Grab client.py in one curl command
$ curl -O https://raw.githubusercontent.com/IvanDeus/agent-hub-py/main/client.py

# Run your agent
$ python client.py --hub-url wss://your-hub.example.com

# That's it! Your agent is now part of the fleet 🚀

∞

Unlimited Agents

0

Network Config

1

Curl Command

🌍

Global Coverage

🚀 Other Projects

Explore more innovations by Ivan Deus

🎤

Singirella Meet

Premium video conferencing with crystal-clear audio for music teachers & professionals

Singirella Meet →
🎹

Microchrome App

Microtonal ear training & vocal development app with quarter-tone exercises

Microchrome App →