Sunholo AI Protocol Platform v6

Open-source AI protocol platform — Skills + AG-UI + A2UI + MCP Apps + A2A on Google ADK.

🚀 New here? Start with WORKSHOP.md — clone, set LOCAL_MODE=1, run make dev, working chat UI in under 30 minutes with zero GCP credentials. Use this for university courses, workshop attendees, or quick exploration of the protocol stack.

What's New in v6

• Skills replace Assistants — clearer user-facing abstraction
• Google ADK — native agent orchestration (replaces Sunholo framework)
• Protocol-native — AG-UI, A2UI, MCP Apps, A2A, MCP
• Three model providers — Gemini, Claude, OpenAI
• OpenTelemetry — native observability from ADK

Quick Start

Backend

cd backend
make install
make dev          # API on port 1956
make playground   # ADK dev UI on port 8501

Frontend

cd frontend
npm install
npm run dev       # Next.js on port 3000

API Reference

The backend exposes a self-documenting API:

• Interactive docs: http://localhost:1956/docs (Swagger UI — all routes, try them live)
• OpenAPI JSON: http://localhost:1956/openapi.json — pipe to jq '.paths | keys' to list all routes
• Skill invocation (AG-UI streaming): POST /api/skill/{skill_id}/stream
• Bare ADK routes (dev only): exposed by get_fast_api_app(web=True) — use the skill route above in production

ADK app_name gotcha: The canonical app name is aitana_platform (the APP_NAME constant in backend/adk/agui.py). The dev UI's /list-apps historically returned filesystem directory names — this version returns the correct APP_NAME. Never derive app_name from /list-apps paths in code; always import the APP_NAME constant.

Architecture

platform/
├── frontend/     # Next.js 14 + React 18 + AG-UI + A2UI + MCP Apps
├── backend/      # FastAPI + Google ADK
├── cli/          # `aiplatform` CLI
├── docs/         # Design documents
└── firestore.rules

See CLAUDE.md for detailed development guidelines.

See docs/design/v5.0.0/migration-to-v6.md for the full migration plan.