Run AI agents across your laptop, desktop, cloud servers, and team members' computers. SSH-powered auto-discovery and seamless orchestration for distributed AI workflows.
"Our 3-person team shares a dev server. Agents run where the resources are."
Unlock the power of multiple machines working together
Split heavy tasks across machines. Run frontend agents on your laptop while backend services run on a powerful desktop or cloud instance.
Connect to AWS, GCP, or Azure instances for GPU-accelerated tasks, large-scale testing, or data-intensive operations without leaving your dashboard.
Share peer machines with team members. Everyone sees the same dashboard, same agents, same real-time terminals. Perfect for remote teams.
See CPU, memory, and network usage across all peer machines from one dashboard. Optimize agent placement based on real-time metrics.
All communication uses SSH with key-based authentication. No exposed ports, no security risks. Works with existing SSH configs and jump hosts.
Configure hosts once. AI Maestro automatically discovers tmux sessions on all peer machines and displays them in your dashboard.
Peer mesh network powered by secure connections
YOUR BROWSER (any node at :23000)
┌──────────────────────┐
│ │
┌────┴────┐ ┌────┴────┐
│ Laptop │◄─────────►│Mac Mini │
│ (Peer) │ │ (Peer) │
└────┬────┘ └────┬────┘
│ │
└──────────┬──────────┘
│
┌─────┴─────┐
│AWS Server │
│ (Peer) │
└───────────┘
Every node is equal - no central server
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ PEER 1 │ │ PEER 2 │ │ PEER 3 │
│ Laptop (macOS) │ │ Desktop (Linux) │ │ Cloud (AWS EC2) │
│ │ │ │ │ │
│ tmux sessions: │ │ tmux sessions: │ │ tmux sessions: │
│ • frontend-ui │ │ • backend-api │ │ • ml-training │
│ • docs-agent │ │ • database │ │ • gpu-tasks │
│ • testing │ │ • redis │ │ • data-proc │
└──────────────────┘ └──────────────────┘ └──────────────────┘curl -fsSL https://raw.githubusercontent.com/23blocks-OS/ai-maestro/main/scripts/remote-install.sh | sh
Install AI Maestro on your main machine (laptop/desktop). This becomes your first node in the mesh.
curl -fsSL https://raw.githubusercontent.com/23blocks-OS/ai-maestro/main/scripts/remote-install.sh | sh
Same installer works on all machines.
# ~/.aimaestro/peers.yml
peers:
- name: desktop
host: desktop.local
- name: cloud
host: ec2-user@aws-instance
- name: team-server
host: team@company.comDefine peers once. Auto-discovery handles the rest.
All tmux sessions from all peers appear in your dashboard automatically.
Pro Tip: Peers can be anywhere - local network, cloud, behind VPN, or even team members' machines. As long as network connectivity works, AI Maestro works.
Common scenarios where distributed architecture shines
You have a laptop for mobility and a desktop for heavy workloads. Run lightweight agents on your laptop, but offload database migrations, large builds, or ML training to your desktop.
Laptop: UI agents, API testing
Desktop: Database, Redis, ML training
Control: All from laptop dashboard
Working from coffee shop with limited bandwidth? Keep heavy tasks running on your home office machine. Access them securely via SSH from anywhere.
Coffee Shop: Active development
Home Office: Background jobs, builds
Same workflow: Seamless switching
Share access to peer machines across your team. Everyone can monitor integration tests, access shared development databases, or collaborate on pair programming sessions.
Shared Peers: CI/CD, staging env
Personal Peers: Individual dev
One Dashboard: Unified team view
Keep fast feedback loops local, but leverage cloud GPUs or large instances for specialized tasks. Spin up/down cloud peers as needed while maintaining local control.
Local: Fast iteration cycles
AWS/GCP: GPU training, big data
Cost: Only pay when cloud is used
Power user capabilities
Access peers behind corporate firewalls or VPNs using SSH ProxyJump configuration.
# ~/.ssh/config
Host production-peer
HostName 10.0.1.50
ProxyJump bastion.company.com
User deployerFull SSH config support - custom ports, specific identity files, connection options.
# ~/.ssh/config
Host cloud-gpu
HostName gpu.example.com
Port 2222
IdentityFile ~/.ssh/gpu_key
StrictHostKeyChecking noSet CPU/memory limits per peer to prevent any single agent from consuming all resources.
# peers.yml
peers:
- name: desktop
host: desktop.local
limits:
cpu: 50%
memory: 8GBPeers go offline? No problem. AI Maestro automatically reconnects when they're back online.
# Automatic behavior:
# - Retry every 30 seconds
# - Exponential backoff
# - Mark offline in dashboard
# - Reconnect when availableExport, transfer, clone, and backup your AI agents across any machine
See full Agent Management guide →
Export any agent to a portable .zip file. Includes configuration, memory database, message history, and git repository references.
Agent Settings → Export → Downloads .zip file
Drop .zip files into AI Maestro on any machine. Automatically restores configuration, memory, and messages. Offers to clone git repositories.
New Host → Import Agent → Select file → Restored!
Create copies of agents on the same machine or across hosts. Perfect for spinning up multiple similar agents or creating backups before experiments.
Export → Import on same machine → New agent clone
Keep backups of your critical agents. Restore from any point in time. Perfect for team onboarding or disaster recovery.
Weekly exports → Cloud storage → Instant recovery
Configuration
Registry settings
Memory DB
CozoDB database
Messages
Inbox & sent
Git Repos
Remote URLs
Moving to a new laptop? Export all agents, import on new machine, and you're back to work in minutes.
Share pre-configured agent setups with new team members. Everyone starts with the same optimized configurations.
Move agents between local machine and peer hosts. Optimize placement based on workload requirements.
Multi-computer mode is excellent for distributed workloads. Consider Docker when you need:
Complete dependency isolation without affecting host system
Identical environments across development, staging, and production
Install in 15 minutes. Works with existing network setup. Unlimited peers.