Demo Catalog¶
See what you can build with Nexo. Every example below is a production-ready integration pattern you can clone, customize, and deploy.
- Clone any example and run it locally
- Test against live deployed instances immediately
- Deploy to Cloud Run with a single command
All webhook demos expose a GET / service-discovery endpoint with service info, supported routes, auth expectations, and schema version.
Webhook vs. hosted examples¶
The folder split is by contract type:
examples/webhook/*-- services that receive Nexo webhook events and return response envelopes.examples/hosted/*-- reference HTTP APIs for capability demos and contract testing.
Both are deployable and production-ready.
Live deployed demos¶
| Demo | Contract | Capability | Live URL | Source |
|---|---|---|---|---|
| News Feed RAG | Webhook | RSS ingestion + retrieval + source cards | nexo-news-rag | news-rag/python |
| Sports Feed RAG | Webhook | Scores, standings, news routing + event detection | nexo-sports-rag | sports-rag/python |
| Travel RAG | Webhook | Destination and itinerary retrieval | nexo-travel-rag | travel-rag/python |
| Football Live RAG | Webhook | Live matches, standings, top scorers | nexo-football-live | football-live/python |
| Daily Routines | Webhook | Morning briefings, schedule actions, follow-up nudges | nexo-routines | routines/python |
| Food Ordering | Webhook | Discovery, basket, checkout, tracking, reorder | nexo-food-ordering | food-ordering/python |
| Travel Planning | Webhook | Itinerary, flights, booking handoff, budget, disruption handling | nexo-travel-planning | travel-planning/python |
| Sky Diamond | Webhook | Stateful detective game with rich cards, prompt suggestions, JSON, and SSE | luzia-sky-diamond | detective-game/python |
| Fitness Coach | Webhook | Workout plans, progress checks, nutrition guidance | nexo-fitness-coach | fitness-coach/python |
| Language Tutor | Webhook | Phrase coaching, quizzes, lesson plans | nexo-language-tutor | language-tutor/python |
| OpenClaw Bridge | Webhook | Nexo webhook to OpenClaw /v1/responses adapter |
nexo-openclaw-bridge | openclaw-bridge/typescript |
| Hosted Python API | Reference API | Minimal authenticated reference API | nexo-examples-py | hosted/python |
| Hosted TypeScript API | Reference API | Minimal authenticated reference API | nexo-examples-ts | hosted/typescript |
| Demo Receiver | Reference API | Webhook contract receiver for smoke testing | nexo-demo-receiver | hosted/demo-receiver |
Webhook examples¶
| Example | Language | What it demonstrates |
|---|---|---|
webhook/minimal |
Python + TypeScript | Smallest valid webhook implementation |
webhook/structured |
Python | Rich card/action response envelope |
webhook/advanced |
Python | Signature verification, retries, idempotency |
webhook/openclaw-bridge |
TypeScript | OpenClaw integration with signed webhook verification |
webhook/news-rag |
Python | Feed ingestion + retrieval + citations |
webhook/sports-rag |
Python | Multi-source sports retrieval + intent routing |
webhook/travel-rag |
Python | Destination knowledge + travel advice |
webhook/football-live |
Python | Live football domain with structured cards |
webhook/routines |
Python | Morning briefings, schedule actions, and follow-up nudges |
webhook/food-ordering |
Python | Menu search, order composition, and checkout flow |
webhook/travel-planning |
Python | Multi-step itinerary, budget, and disruption replanning |
webhook/detective-game |
Python | Stateful game runtime with pinned thread progress, cards, and SSE |
webhook/fitness-coach |
Python | Workout plans, progress snapshots, and nutrition guidance |
webhook/language-tutor |
Python | Language phrase help, quizzes, and lesson plans |
Partner API proactive scripts¶
CLI tooling for pushing events through the Partner API:
| Example | Languages | Purpose |
|---|---|---|
partner-api/proactive |
Bash, Python, TypeScript | Partner-initiated event delivery and auth |
Suggested reading path¶
- Quickstart -- implement your first webhook in minutes.
- Demo Catalog -- pick the capability pattern you want.
- Examples Deep Dive -- inspect architecture and payloads.
- Hosting -- deploy to Cloud Run.
- API Reference -- full contract details.