Basic Examples

Basic Examples#

Real MassGen examples using the CLI and YAML configuration.

Note

All examples use real CLI commands and YAML configurations. These examples work with actual MassGen.

Quick Start Examples#

Single Agent - Model Flag#

Test any model without configuration:

# Test Claude
massgen --model claude-3-5-sonnet-latest "What is machine learning?"

# Test Gemini
massgen --model gemini-2.5-flash "Explain quantum computing"

# Test GPT-5
massgen --model gpt-5-nano "Summarize recent AI developments"

Single Agent - Configuration File#

Using a configuration file:

Configuration: @examples/basic/single/single_gpt5nano.yaml

agents:
  - id: "gpt-5-nano"
    backend:
      type: "openai"
      model: "gpt-5-nano"
      enable_web_search: true
      enable_code_interpreter: true

ui:
  display_type: "rich_terminal"
  logging_enabled: true

Run:

massgen \
  --config @examples/basic/single/single_gpt5nano.yaml \
  "Calculate the first 100 prime numbers and plot their distribution"

See also

Configuration - Complete configuration syntax and all available options

Multi-Agent Collaboration#

Three Agents Working Together#

The recommended starting point for multi-agent collaboration:

Configuration: @examples/basic/multi/three_agents_default.yaml

agents:
  - id: "gemini2.5flash"
    backend:
      type: "gemini"
      model: "gemini-2.5-flash"
      enable_web_search: true

  - id: "gpt5nano"
    backend:
      type: "openai"
      model: "gpt-5-nano"
      enable_web_search: true
      enable_code_interpreter: true

  - id: "grok3mini"
    backend:
      type: "grok"
      model: "grok-3-mini"
      enable_web_search: true

This showcases:

  • Gemini 2.5 Flash - Fast research with web search

  • GPT-5 Nano - Advanced reasoning with code execution

  • Grok-3 Mini - Real-time information

Run:

massgen \
  --config @examples/basic/multi/three_agents_default.yaml \
  "Analyze the pros and cons of renewable energy"

Interactive Mode#

Multi-Turn Conversations#

Start interactive mode by omitting the question:

# Start interactive session
massgen \
  --config @examples/basic/multi/three_agents_default.yaml

See also

Interactive Multi-Turn Mode - Complete interactive mode guide with commands and session management

Tool Usage Examples#

Code Execution#

GPT-5 and Gemini support code execution:

# Code generation and execution
massgen \
  --model gpt-5-nano \
  "Write Python code to analyze CSV data and create visualizations"

# Multi-agent coding
massgen \
  --config @examples/basic/multi/three_agents_default.yaml \
  "Create a script to calculate Fibonacci numbers and plot the sequence"

MCP Integration Examples#

Weather Information#

Using MCP for external tools:

Configuration: @examples/tools/mcp/gpt5_nano_mcp_example.yaml

agents:
  - id: "gpt5_nano_mcp_weather"
    backend:
      type: "openai"
      model: "gpt-5-nano"
      mcp_servers:
        - name: "weather"
          type: "stdio"
          command: "npx"
          args: ["-y", "@fak111/weather-mcp"]

Run:

massgen \
  --config @examples/tools/mcp/gpt5_nano_mcp_example.yaml \
  "What's the weather forecast for New York this week?"

Multi-Server MCP#

Using multiple MCP servers:

Configuration: @examples/tools/mcp/multimcp_gemini.yaml

Run:

# Requires BRAVE_API_KEY in .env
massgen \
  --config @examples/tools/mcp/multimcp_gemini.yaml \
  "Find the best restaurants in Paris and save recommendations to a file"

File Operations Examples#

Claude Code with Files#

File operations with Claude Code:

Configuration: @examples/tools/filesystem/claude_code_single.yaml

Run:

massgen \
  --config @examples/tools/filesystem/claude_code_single.yaml \
  "Create a Python project structure with tests and documentation"

Multi-Agent File Collaboration#

Multiple agents working with files:

Run:

massgen \
  --config @examples/tools/filesystem/claude_code_context_sharing.yaml \
  "Analyze code quality and generate improvement recommendations"

Common Use Cases#

Question Answering#

# Simple question
massgen \
  --model gemini-2.5-flash \
  "What is the capital of France?"

# Complex research
massgen \
  --config @examples/basic/multi/three_agents_default.yaml \
  "Compare different programming paradigms and their use cases"

Research & Analysis#

# Current events research
massgen \
  --config @examples/basic/multi/three_agents_default.yaml \
  "What's best to do in Stockholm in October 2025"

# Technical research
massgen \
  --config @examples/basic/multi/three_agents_default.yaml \
  "Compare cloud providers for machine learning workloads"

Creative Writing#

# Story generation
massgen \
  --config @examples/basic/multi/three_agents_default.yaml \
  "Write a short story about a robot who discovers music"

Development Tasks#

# Code generation
massgen \
  --config @examples/tools/filesystem/claude_code_single.yaml \
  "Create a Flask web app with authentication"

# Code review
massgen \
  --config @examples/tools/filesystem/claude_code_single.yaml \
  "Review Python code in workspace/ and suggest improvements"

Configuration Examples Directory#

All examples are in @examples/:

Basic:

  • basic/single/ - Single agent configurations

  • basic/multi/ - Multi-agent configurations

Tools:

  • tools/mcp/ - MCP integration examples

  • tools/filesystem/ - File operation examples

  • tools/web-search/ - Web search configurations

  • tools/code-execution/ - Code execution examples

Providers:

  • providers/openai/ - OpenAI-specific examples

  • providers/claude/ - Claude-specific examples

  • providers/gemini/ - Gemini-specific examples

  • providers/local/ - Local model examples

See the Configuration README for the complete catalog.

Best Practices#

  1. Start Simple: Begin with single agent, then scale to multi-agent

  2. Test Incrementally: Verify each feature before combining

  3. Use Real Configs: Copy from @examples/ and modify

  4. Check Logs: Use --debug for troubleshooting

  5. Read Documentation: Each config file has usage comments

Next Steps#

Troubleshooting#

Example not working:

  1. Check API key in .env file

  2. Verify configuration path is correct

  3. Use --debug flag to see detailed logs

  4. Test with simpler question first

Configuration file not found:

# Correct - relative to MassGen root
--config @examples/basic/multi/three_agents_default.yaml

# Incorrect - missing massgen/ prefix
--config configs/basic/multi/three_agents_default.yaml

MCP server not found:

# Install MCP server
npx -y @fak111/weather-mcp

# Or install globally
npm install -g @fak111/weather-mcp