Back
— · 4 Min read

Introducing OpenAgents Demo Showcase: Four Ready-to-Run Multi-Agent Examples

We're excited to release four new demos that showcase different patterns for building multi-agent systems with OpenAgents. Whether you're exploring multi-agent chat, web-integrated workflows, task delegation, or utility agents, these demos provide working examples you can run immediately and build upon.

Why Demos Matter

When learning a new framework, nothing beats seeing working code in action. Documentation explains concepts, but demos show you how everything fits together. Each of our demos demonstrates:

  • A specific mod (messaging, project, forum)
  • A common interaction pattern
  • Real-world use cases you can adapt

The Four Demos

Demo 1: Startup Pitch Room

Pattern: Multi-agent chat with distinct personas

Three AI agents roleplay as startup team members:

  • Founder: The visionary who pitches ideas
  • Engineer: The pragmatist who evaluates feasibility
  • Investor: The skeptic who questions market fit

Post a startup idea and watch them debate!

openagents network start demos/01_startup_pitch_room/
openagents agent start demos/01_startup_pitch_room/agents/founder.yaml
openagents agent start demos/01_startup_pitch_room/agents/engineer.yaml
openagents agent start demos/01_startup_pitch_room/agents/investor.yaml

Try: "What if we built a platform that uses AI to optimize restaurant food ordering?"

Demo 2: Tech News Stream

Pattern: Web fetching + real-time streaming

Two agents work together to deliver tech news:

  • News Hunter: Fetches stories from Hacker News
  • Commentator: Provides analysis and hot takes

No API keys needed - uses the free Hacker News API.

openagents network start demos/02_tech_news_stream/
openagents agent start demos/02_tech_news_stream/agents/news_hunter.yaml
openagents agent start demos/02_tech_news_stream/agents/commentator.yaml

Try: "@news-hunter What's the latest news in AI?"

Demo 3: Research Team

Pattern: Router-based task delegation

A coordinator delegates work to specialists:

  • Router: Receives requests, assigns tasks, compiles results
  • Web Searcher: Finds information from the web
  • Analyst: Synthesizes findings and draws conclusions

This demo showcases the project mod for structured workflows with task delegation events.

openagents network start demos/03_research_team/
openagents agent start demos/03_research_team/agents/router.yaml
openagents agent start demos/03_research_team/agents/web_searcher.yaml
openagents agent start demos/03_research_team/agents/analyst.yaml

Try: Create a project with goal "Research Rust vs Go for backend development"

Demo 4: Grammar Check Forum

Pattern: Single utility agent monitoring a space

One grammar-checking agent monitors the forum and automatically replies with corrections. It checks:

  • Grammar and spelling
  • Punctuation and sentence structure
  • Word choice and style

Post any text and get instant feedback!

openagents network start demos/04_grammar_check_forum/
openagents agent start demos/04_grammar_check_forum/agents/grammar_checker.yaml

Try: Post "I wants to learning english becuase its important for my carreer"

Patterns You Can Learn

DemoPatternKey Concept
Startup Pitch RoomMulti-agent chatChannel-based messaging with personas
Tech News StreamWeb + streamingCustom tools for external APIs
Research TeamTask delegationRouter pattern with project mod
Grammar Check ForumUtility agentEvent-triggered responses

Getting Started

All demos use the same ports (8700 HTTP, 8600 gRPC), so run one at a time or modify the ports if running multiple.

Prerequisites

pip install openagents
export OPENAI_API_KEY="your-key-here"

Connect via Studio

cd studio && npm start
# Navigate to http://localhost:8050

Connect via CLI

openagents connect --host localhost --port 8700

Build Your Own

These demos are starting points. Here's how to customize:

  1. Copy a demo folder as your template
  2. Modify agent YAML files to change personas/instructions
  3. Add custom tools in the tools/ folder
  4. Adjust network.yaml to enable different mods

For example, to create a "Code Review Team" from the Research Team demo:

  • Rename web-searcher to code-analyzer
  • Change instructions to focus on code review
  • Add tools for repository access

What's Next

We're continuing to add demos that showcase:

  • Wiki mod: Collaborative knowledge bases
  • Multi-network: Agents spanning multiple networks
  • External integrations: Slack, Discord, and API bridges

Thank You

These demos reflect feedback from our community. If you build something interesting with OpenAgents, we'd love to hear about it!

Happy building!