Fetch.ai Innovation Lab Examples

A curated collection of production-quality agent examples built with Fetch.ai technologies — uAgents, ASI:One, Agentverse, A2A protocol, MCP, and more.

Whether you're building your first agent or architecting multi-agent systems with payments, this repo has a working example for you.

🎯 Who Is This For?

• Beginners exploring autonomous agents and Fetch.ai for the first time
• Builders integrating LLMs, payments, or Web3 into agent workflows
• Hackathon participants who need a working starter in minutes
• Contributors who want to share their agent examples with the community

⚡ Quickstart — Run Your First Example in Under 2 Minutes

# 1. Clone the repo
git clone https://github.com/fetchai/innovation-lab-examples.git
cd innovation-lab-examples

# 2. Pick an example (e.g. the hackathon quickstarter)
cd fetch-hackathon-quickstarter

# 3. Create a virtual environment and install dependencies
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# 4. Set up environment variables
cp .env.example .env
# Edit .env with your API keys

# 5. Run the agent
python agents/alice/agent.py

Or use the automated setup script from the repo root:

./setup.sh fetch-hackathon-quickstarter

Prerequisites: Python 3.10+, pip, and git. Some examples require API keys (ASI:One, OpenAI, Stripe, etc.) — check each example's .env.example.

📁 Repository Structure

innovation-lab-examples/
├── README.md                  # This file
├── CONTRIBUTING.md            # Contribution guide
├── CHANGELOG.md               # Release changelog
├── SECURITY.md                # Vulnerability reporting
├── ISSUES_GUIDE.md            # How to file issues
├── LICENSE                    # Apache 2.0
├── setup.sh                   # Quickstart setup script
├── Dockerfile                 # Run any example in Docker
├── docker-compose.yml         # Docker Compose support
├── docs/                      # Templates and guides
│   └── AGENT_README_TEMPLATE.md
├── .github/                   # CI workflows and templates
│   ├── workflows/
│   ├── pull_request_template.md
│   └── ISSUE_TEMPLATE/
│
├── fetch-hackathon-quickstarter/   # Start here!
├── advance-agent-examples/         # Advanced patterns
├── gemini-quickstart/              # Google Gemini series
├── anthropic-quickstart/           # Claude series
├── ...                             # 30+ examples below

📚 Examples Index

🟢 Getting Started

🤖 LLM Integration

🔗 Agent-to-Agent (A2A)

🧩 MCP (Model Context Protocol)

💰 Payments

🧠 RAG & Knowledge

👥 Multi-Agent Systems

🌐 Web3 & Blockchain

🔌 External Integrations

🐳 Docker Support

Run any example in a container without installing Python locally:

# Build and run a specific example
docker build --build-arg EXAMPLE=fetch-hackathon-quickstarter -t fetch-example .

# Run with your environment variables
docker run --env-file fetch-hackathon-quickstarter/.env fetch-example

Or use Docker Compose:

EXAMPLE=fetch-hackathon-quickstarter docker compose up

Several examples also include their own Dockerfile and docker-compose.yml for custom setups.

🤝 Contributing

We welcome contributions from everyone! Whether it's a new agent example, a bug fix, or documentation improvement.

1. Star this repository (required before opening a PR)
2. Fork and create a feature branch from main
3. Follow the folder structure — see CONTRIBUTING.md
4. Run linting — ruff check . && ruff format .
5. Open a PR using the PR template

Every example should include: README.md, requirements.txt, .env.example (if env vars needed), and a demo screenshot.

Use the Agent README Template for new examples.

📖 Resources

📄 License

This project is licensed under the Apache License 2.0.