innovation-lab-examples README

The project's README from github.com/fetchai/innovation-lab-examples. As one markdown file: README.md.

Fetch.ai Innovation Lab Examples

80+ production-ready AI agent examples in Python

Build autonomous AI agents, multi-agent systems and agentic AI workflows with uAgents, ASI:One, Agentverse, MCP, the A2A protocol, LangChain, CrewAI, Gemini, Claude and OpenAI.

License PRs Welcome Stars Forks Python Docs

Quickstart · Examples · Structure · Docker · Contributing · FAQ

📈 Star history

GitHub stars GitHub forks Contributors Last commit

If these examples save you time, a ⭐ helps other developers find them.


Every folder here is a self-contained, runnable AI agent project with its own README, dependencies and environment template. Whether you are writing your first autonomous agent or architecting a multi-agent system with real payments, there is a working example to start from.

🎯 Who is this for?


⚡ Quickstart

Run your first agent in under two 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           # How to contribute
├── 📄 SECURITY.md               # Vulnerability reporting
├── 📄 ISSUES_GUIDE.md           # How to file a good issue
├── 📄 LICENSE                   # Apache 2.0
├── 🔧 setup.sh                  # One-command example setup
├── 🐳 Dockerfile                # Run any example in a container
├── 🐳 docker-compose.yml        # Compose support
├── 🔧 ruff.toml                 # Repo-wide lint baseline
│
├── 📂 .github/                  # CI and contributor templates
│   ├── workflows/               #   ci · pull_request_ci · review-required · pr-ai-review
│   ├── scripts/                 #   run-example-tests.sh (per-example test runner)
│   ├── ISSUE_TEMPLATE/
│   ├── pull_request_template.md
│   ├── CODEOWNERS
│   └── BRANCH_PROTECTION.md
│
├── 📂 scripts/                  # Repository tooling
│   └── pr-ai-review.mjs         #   ASI:One code review for pull requests
│
├── 📂 docs/                     # Shared guides and templates
│   └── AGENT_README_TEMPLATE.md
│
├── 📂 contributors/             # 👈 Community agents go here
│   ├── README.md                #   Contributor guide
│   ├── CHANGELOG.md             #   Community changelog
│   ├── community_agent/
│   ├── news-summarizer-agent/
│   └── gemini-task-manager-agent/
│
├── 🟢 Getting started
│   ├── fetch-hackathon-quickstarter/   # 👈 Start here
│   ├── av-script-example/
│   ├── asi-cloud-agent/
│   ├── deploy-agent-on-av/
│   ├── openclaw/
│   └── cursor-rules/
│
├── 🤖 LLM integration
│   ├── asi1-llm-example/
│   ├── dynamic-ui-on-asi1/          # ASI:One interactive cards (TripMate + news)
│   ├── anthropic-quickstart/
│   ├── gemini-quickstart/
│   ├── openai-agent-sdk/
│   ├── Claude Agent SDK/
│   ├── google-genai-parallel-processing/
│   ├── flight-tracker-openai-workflow-agent/
│   ├── langchain-agents/
│   ├── pydantic-agent/
│   └── security-scanner-agent/
│
├── 🔗 Agent-to-agent (A2A)
│   ├── launch-your-a2a-agent/
│   ├── launch-your-a2a-research-team/
│   ├── a2a-cart-store/
│   └── a2a-uAgents-Integration/
│
├── 🧩 MCP
│   └── mcp-agents/
│
├── 💰 Payments
│   ├── fet-example/
│   ├── image-agent-payment-protocol/
│   ├── stripe-horoscope-agent/
│   └── stripe-payment-agents/
│
├── 🧠 RAG and knowledge
│   ├── Rag-agent/
│   ├── llama-index/
│   └── pdf-summariser-example/
│
├── 👥 Multi-agent systems
│   ├── google-adk/
│   ├── Crewai-agents/
│   ├── ag2-agents/
│   └── video-to-map-agent/
│
├── 🌐 Web3
│   ├── web3/
│   └── duffel-agent/
│
└── 🔌 External integrations
    ├── Composio/
    ├── Browser-based-agents/
    └── frontend-integration/

📚 Examples index

🟢 Getting Started

Example Description Tech Stack Difficulty
fetch-hackathon-quickstarter Hackathon-ready template with orchestrator + worker agents Python, uAgents 🟢 Beginner
openclaw/ OpenClaw — connector + orchestrator (fetchai-openclaw-orchestrator) and Agentverse caller skill (agentverse-caller) Python, Shell, OpenClaw, Agentverse, uAgents 🟢–🟡
av-script-example Agentverse script deployment example Python, uAgents 🟢 Beginner
asi-cloud-agent Basic ASI Cloud agent deployment Python, uAgents 🟢 Beginner
deploy-agent-on-av Deploy agents on Agentverse via Render Python, uAgents, Render 🟢 Beginner
cursor-rules Cursor IDE rules for Fetch.ai development MDC rules 🟢 Beginner

🤖 LLM Integration

Example Description Tech Stack Difficulty
asi1-llm-example ASI:One LLM with LangChain integration Python, LangChain, ASI:One 🟢 Beginner
dynamic-ui-on-asi1 ASI:One interactive cards — TripMate (flights/hotels/packages via lastminute.com MCP) and news-card-agent (live news carousel) Python, uAgents, ASI:One, Cards, MCP, Tavily 🟡 Intermediate
anthropic-quickstart Claude integration series — basic, vision, functions, MCP, multi-agent Python, Anthropic SDK, uAgents 🟢–🔴 Series
gemini-quickstart Google Gemini series — text, Imagen, Veo, Lyria, TTS, research, film Python, Google Gemini, uAgents 🟢–🔴 Series
openai-agent-sdk OpenAI Agents SDK examples (scholarship finder) Python, OpenAI SDK, uAgents 🟡 Intermediate
Claude Agent SDK Real estate search agent with Claude SDK Python, Claude SDK, uAgents 🟡 Intermediate
google-genai-parallel-processing Parallel processing with Google GenAI Python, Google GenAI, uAgents 🟡 Intermediate
flight-tracker-openai-workflow-agent Flight tracking with OpenAI workflow agents Python, OpenAI SDK, uAgents 🟡 Intermediate
langchain-agents Hackflow — hackathon competitive-intelligence agent built on LangChain Deep Agents with Stripe payments Python, LangChain, uAgents, Stripe 🔴 Advanced
pydantic-agent Shipping label booking agent using Pydantic AI and ASI:One interactive cards Python, Pydantic AI, uAgents, Shippo 🔴 Advanced
security-scanner-agent LLM-powered code security scanner returning structured vulnerability reports Python, uAgents, ASI:One 🟡 Intermediate

🔗 Agent-to-Agent (A2A)

Example Description Tech Stack Difficulty
launch-your-a2a-agent Quick A2A agent launcher Python, uAgents, A2A 🟢 Beginner
launch-your-a2a-research-team Multi-agent A2A research team Python, uAgents, A2A 🟡 Intermediate
a2a-cart-store A2A shopping cart with Skyfire payments Python, uAgents, Skyfire 🟡 Intermediate
a2a-uAgents-Integration A2A communication examples (YouTube, shopping, currency, competitor analysis) Python, uAgents, LangGraph 🟡–🔴 Collection

🧩 MCP (Model Context Protocol)

Example Description Tech Stack Difficulty
mcp-agents MCP server agents — Gmail, Calendar, Events, Airbnb, Perplexity, GitHub, Context7 Python, MCP, uAgents 🟡 Intermediate

💰 Payments

Example Description Tech Stack Difficulty
fet-example FET payment + ASI:One image generation agent Python, uAgents, ASI:One, FET 🟡 Intermediate
image-agent-payment-protocol Image generation with payment protocol Python, uAgents, Skyfire 🟡 Intermediate
stripe-horoscope-agent Horoscope agent with Stripe payments Python, uAgents, Stripe 🟡 Intermediate
stripe-payment-agents Stripe payment examples (property finder, expense calculator) Python, uAgents, Stripe 🔴 Advanced

🧠 RAG & Knowledge

Example Description Tech Stack Difficulty
Rag-agent RAG agent with vector search Python, uAgents, RAG 🟡 Intermediate
llama-index LlamaIndex RAG agent with Stripe payments Python, LlamaIndex, uAgents, Stripe 🔴 Advanced
pdf-summariser-example PDF summarization agent Python, uAgents, ASI:One 🟢 Beginner

👥 Multi-Agent Systems

Example Description Tech Stack Difficulty
google-adk Google ADK patterns — sub-agents, search, policy, security, SEO audit, due diligence, trends Python, uAgents, Google ADK 🟡–🔴 Collection
Crewai-agents CrewAI agents — trip planner, code analyzer, meeting prep, blood report Python, CrewAI, uAgents 🟡–🔴 Collection
ag2-agents AG2 framework — research synthesis, payment approval Python, AG2, uAgents 🔴 Advanced
video-to-map-agent Turns YouTube travel vlogs into a day-by-day itinerary with route map, PDF and Excel output Python, uAgents, ASI:One, Google Maps, Stripe 🔴 Advanced

🌍 Community Contributors

New community agents belong in contributors/ — see contributors/README.md.

Example Description Tech Stack Difficulty
contributors/community_agent AI community growth agent for events and hackathons Python, uAgents, ASI:One, Tavily 🟡 Intermediate
contributors/news-summarizer-agent Fetches top headlines for a topic via NewsAPI and summarizes them with ASI:One, via Chat Protocol Python, uAgents, NewsAPI, ASI:One 🟡 Intermediate
contributors/gemini-task-manager-agent Natural-language task manager backed by Gemini Python, uAgents, Gemini 🟡 Intermediate

🌐 Web3 & Blockchain

Example Description Tech Stack Difficulty
web3 Web3 integrations — SingularityNET MeTTa, Internet Computer Python, MeTTa, ICP, uAgents 🔴 Advanced
duffel-agent Flight booking agent with Duffel API and payments Python, uAgents, Duffel, OpenAI 🔴 Advanced

🔌 External Integrations

Example Description Tech Stack Difficulty
Composio Composio agents — Gmail and LinkedIn automation Python, Composio, uAgents 🟡 Intermediate
Browser-based-agents Browser automation agents (Nike product scraper, job-application agent) Python, Notte, Playwright, uAgents 🟡 Intermediate
frontend-integration Next.js + uAgents frontend integration Python, Next.js, uAgents 🟡 Intermediate

🐳 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 — a new agent example, a bug fix or a documentation improvement.

  1. Star this repository (required before opening a PR)
  2. Fork and create a feature branch from main
  3. New agents go in contributors/<your-agent-name>/ — see contributors/README.md
  4. Pick an issue — good first issues or feature challenges (real-time booking, payments, etc.)
  5. Run linting — ruff check . && ruff format .
  6. Run the tests — bash .github/scripts/run-example-tests.sh <your-example>
  7. Open a PR using the PR template — PRs require maintainer review before merge

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

Use the Agent README Template for new examples.


📖 Resources

Resource Link
Innovation Lab Docs innovationlab.fetch.ai/resources/docs/intro
Agentverse agentverse.ai
ASI:One API asi1.ai
uAgents Framework github.com/fetchai/uAgents
Contributing Guide CONTRIBUTING.md
Community Agents Folder contributors/README.md
Security Policy SECURITY.md
Community Changelog contributors/CHANGELOG.md
Issues Guide ISSUES_GUIDE.md

❓ FAQ

What is an AI agent?

An AI agent is a program that perceives its environment, decides what to do and acts on its own to reach a goal — rather than waiting for step-by-step instructions. The agents in this repo use an LLM for reasoning and the uAgents framework for messaging, discovery and payments.

Which example should I start with?

fetch-hackathon-quickstarter — it shows the orchestrator + worker pattern that most other examples build on. From there, pick the category matching your use case in the examples index.

Do I need API keys?

Most examples need at least one. Each example ships a .env.example listing exactly what it reads. An ASI:One key covers the majority; individual examples may also need OpenAI, Anthropic, Google, Stripe or a vendor key.

Are these examples free to use commercially?

Yes. Everything here is Apache 2.0 licensed. Third-party APIs each example calls have their own terms and pricing.

How do I deploy an agent to production?

See deploy-agent-on-av for Agentverse deployment via Render, and asi-cloud-agent for ASI Cloud. Any example can also run in Docker — see Docker support.

How do multi-agent systems work here?

Two patterns. A2A (agent-to-agent) connects independent agents over a shared protocol — see a2a-uAgents-Integration. Framework orchestration runs a team inside one process — see Crewai-agents, ag2-agents and google-adk.

Can I add my own agent?

Yes, and we would like you to. Put it in contributors/<your-agent-name>/ and read CONTRIBUTING.md first.


📄 License

Licensed under the Apache License 2.0.

Topics: ai-agents · autonomous-agents · multi-agent-systems · agentic-ai · llm-agents · uagents · fetchai · agentverse · asi-one · mcp · a2a-protocol · langchain · crewai · openai · python

Built by the Fetch.ai Innovation Lab and its contributors.

innovation-lab-examples (fetchai/innovation-lab-examples)

Searching Database…

What is this?A collection of 80+ runnable Python AI agent examples built with uAgents, covering everything from basic starter agents to multi-agent systems, MCP, A2A and payments.
Is it a framework or a library I install?Neither, really. It is a set of self-contained example projects, each with its own README, dependencies and environment template. You copy or run the one closest to your use case rather than importing one package.
How do I run my first agent?Pick an example folder, follow its README and install its requirements. The README suggests fetch-hackathon-quickstarter as a first project. Prerequisites are Python 3.10+, pip and git, and Docker can be used to run any example in a container.
Do I need API keys to try the examples?Most examples need at least one. An ASI:One key covers the majority, while others need OpenAI, Anthropic, Google, Stripe or a vendor key. Each example lists the variables it reads in a .env.example file.
Will every example run for free?Not always. The code is Apache 2.0 licensed, but the third-party APIs each example calls have their own terms and pricing, and some examples depend on paid services such as Stripe, Duffel or Shippo.
Is this useful if I have never built an agent before?Yes. The index has beginner-level examples, and fetch-hackathon-quickstarter shows the orchestrator plus worker pattern that most other examples build on. Difficulty rises to advanced for examples using payments and multi-agent frameworks.
What can the agents actually do?Examples cover LLM integrations with ASI:One, Claude, Gemini and OpenAI, agent-to-agent communication, MCP servers for Gmail and GitHub, payments via Stripe, Skyfire and FET, RAG, and multi-agent teams built with CrewAI, AG2 and Google ADK.
What is uAgents and why does it matter here?uAgents is the Fetch.ai framework that handles messaging, discovery and payments for the agents in this repo. The LLMs supply the reasoning on top of it.
How do multi-agent systems work in these examples?There are two patterns. Agent-to-agent (A2A) connects independent agents over a shared protocol, while framework orchestration such as CrewAI, AG2 or Google ADK runs a whole team inside one process.
Can I add my own agent?Yes, and the maintainers invite it. Put it in the contributors folder, read CONTRIBUTING.md first, and include a README, requirements.txt, a .env.example if env vars are used, and a demo screenshot. PRs need maintainer review.
Creator
fetchai
Size
50.9 MB
Stars
1.5K
Updated
CommitSep 01
Age
1y
Commits · 90 Days