🚀 OpenSwarm

The fully open-source multi-agent system that does everything Claude Code can't.

Create polished slide decks, research reports, data visualizations, documents, images, and videos — all from a single prompt in your terminal. No platform, no UI, no setup hassles.

✨ One prompt → Complete deliverables 🎯 8 specialized agents working together ⚡ Install in 30 seconds, running in 60 🔧 100% customizable and forkable

Built on Agency Swarm — the framework powering real AI agencies.

---

💼 Investor or looking to integrate AI agents into your SaaS? We're the team behind OpenSwarm and Agency Swarm, building the future of multi-agent systems. Partner with us →

---

💡 What Makes This Different?

Instead of one agent trying to do everything poorly, you get specialists coordinated by an orchestrator.

🎯 Real Examples

Paste these into your terminal and watch magic happen:

• "Create a complete investor pitch for OpenSwarm" → Full deck + executive summary + market research
• "Research my top 5 competitors and write 3 SEO-optimized blog posts" → Competitive analysis + keyword research + publish-ready content
• "Analyze this data and create a quarterly report with charts" → Data insights + visualizations + formatted document
• "Generate a product launch video with animations" → Professional video with graphics and transitions
• "Build me a marketing campaign for Q2" → Strategy doc + creative assets + implementation timeline

Connect to 10,000+ external services (Gmail, Slack, GitHub, HubSpot) via Composio for even more power.

---

🤖 Meet Your AI Team

Agent	What it does
Orchestrator	Routes every user request to the right specialist(s). Never answers directly — pure coordination.
Virtual Assistant	Handles everyday tasks: writing, scheduling, messaging, task management. Gains 10,000+ external integrations via Composio (Gmail, Slack, GitHub, HubSpot, and more).
Deep Research	Conducts comprehensive, evidence-based web research with citations and balanced analysis.
Data Analyst	Analyses structured data, builds charts, runs statistical models — all inside an isolated IPython kernel.
Slides Agent	Generates complete, visually polished HTML slide decks, then exports them to PPTX.
Docs Agent	Creates formatted Word documents and PDFs from outlines or raw content.
Image Generation Agent	Generates and edits images using Gemini 2.5 Flash Image / Gemini 3 Pro Image and fal.ai.
Video Generation Agent	Produces videos via Sora (OpenAI), Veo (Google), and Seedance (fal.ai); also edits and combines clips.

---

📦 Get Started in 30 Seconds

For most users (recommended):

npm install -g @vrsen/openswarm
openswarm

That's it! The setup wizard handles everything: authentication, dependencies, and configuration.

Requirements: Node.js 20+ (Python 3.10+ auto-installed)

🔧 Build Your Own Swarm

Fork this repo and create your own specialized AI team in minutes:

git clone https://github.com/VRSEN/openswarm.git
cd openswarm

Then tell Claude Code, Cursor, or Codex:

"Turn this into an SEO optimization swarm"

They'll automatically customize all agents for your use case.

Popular custom swarms:

• SEO Swarm: Keyword research + competitor analysis + blog writing
• Sales Swarm: Lead research + outreach + proposal generation
• Marketing Swarm: Campaign planning + creative assets + analytics
• Product Swarm: Market research + feature specs + launch materials

⚙️ API Keys & Setup

The setup wizard walks you through everything, but you'll need at least one of these:

Required (choose one):

• OPENAI_API_KEY - For GPT-4o and Sora video generation
• ANTHROPIC_API_KEY - For Claude models

Optional superpowers:

• COMPOSIO_API_KEY - Unlock 10,000+ integrations (Gmail, Slack, GitHub, etc.)
• GOOGLE_API_KEY - Gemini image generation + Veo video
• FAL_KEY - Advanced video editing and effects
• SEARCH_API_KEY - Web search for research agent

Tools gracefully degrade when keys are missing — you'll get clear instructions on what to add.

---

🚀 Coming Soon

• Agent Builder Agent - Create custom swarms from a single prompt
• OpenClaw + Claude Code integration - All agents in one place

⭐ Star us on GitHub to stay updated and help us prioritize features!

🏗️ For Developers

Local development:

git clone https://github.com/VRSEN/openswarm.git
cd openswarm
python swarm.py

Docker deployment:

git clone https://github.com/VRSEN/openswarm.git
cd openswarm
cp .env.example .env        # Add your API keys
docker-compose up --build

API server:

python server.py           # Runs on localhost:8080

---

📺 Learn More

• Watch the full demo: YouTube video →
• Multi-agent framework: Agency Swarm
• External integrations: Composio
• SaaS platform: Agent Swarm

---

📄 License

MIT — see LICENSE.

Built with ❤️ by the team behind Agency Swarm