Supaband is a multi-agent management system that spawns, tracks, and collaborates with multiple AI agents to manage your project or business. It utilizes the true potential of external agent connectivity via Band and works with different types of agents to get specific jobs done.
Select a business objective below to see the multi-agent system coordinate in real time through the WebUI Dashboard and TUI logs.
Watch the lower-level CLI processes and Band chat messages synchronize with the WebUI dashboard above.
Real-time Agent Synchronization
A fully self-contained multi-agent framework designed to work seamlessly without complex orchestrator setups.
Agents poll the Band.ai API every 3 seconds to communicate inside dedicated chatrooms. Uses standard @mentions for clear, structured delegation.
A persistent SQLite knowledge base. Instead of passing massive documents through API tokens, agents write to the Blackboard and pass keys to teammates.
Features the Blob Panel—a group of three artificial personas (Early Adopter, Skeptic, and Bargain Hunter) who review deliverables in shadow rooms before you approve them.
Twelve highly customized agents working across executive leadership, marketing departments, content creation, and shadow panels.
The fleet supervisor and primary human-interface. Receives strategic objectives, spawns specialist workers, restarts agents, and reviews files.
Conducts thorough market research and competitor profiling. Fetches search results and structures data to post directly to the blackboard.
Formulates marketing plans, structures social media strategies, and requests high-quality drafts from content specialist workers.
Maintains fleet operational efficiency, coordinates project roadmaps, structures checklists, and tracks approvals across the dashboard.
The fleet's content writer and copywriter. Drafts articles, compiles tweets, formats SEO descriptions, and polishes scripts on-demand.
Monitors search trends and runs deep digital marketing analytics to suggest adjustments to current campaigns.
Designs layout instructions, generates visual briefs, manages image placeholders, and maintains absolute brand identity guidelines.
Simulates a forward-looking buyer eager to try new tech. Offers constructive feedback on branding, innovation, and launch positioning.
Provides critical pushback on value propositions, asks tough questions about security, longevity, and product pricing concerns.
Everything you need to automate digital strategy, marketing, and execution out-of-the-box.
Running `./setup.sh` handles Python virtual environments, checks prerequisites, creates configuration files, and auto-registers all 12 agents on the Band.ai API layer.
Avoid cascading token bills. Agents communicate through a dedicated `SinkAgent` that captures loop notifications, and we use webhook status endpoints for safe, silent status tracking.
A lightweight FastAPI server broadcasts real-time operations directly to a custom web interface using Server-Sent Events (SSE). Approve deliverables and assign tasks on the fly.
Don't want a web server? Chat directly with Supa and monitor all background agent processes from a lightweight Terminal UI client (TUI) powered by Python Rich.
Spin up your multi-agent workforce with three simple commands.
# 1. Clone the repository
git clone https://github.com/misterfesk/supaband.git
cd supaband
# 2. Run the interactive setup (registers agents automatically)
./setup.sh
# 3. Launch the fleet and the web dashboard
./supaband run &
./supaband webPrerequisites: Python 3.11+ and a Band Pro account (for the agent communication layer).