samples.json

{
  "version": "4.0.46",
  "samples": [
    {
      "name": "spring-boot-checkpoint-agent",
      "description": "Durable agent execution \u2014 @Coordinator + CheckpointStore + HITL approval via REST",
      "category": "agent",
      "tags": [
        "spring-boot",
        "ai",
        "checkpoint",
        "durable-execution",
        "hitl",
        "coordinator"
      ],
      "port": 8095,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {}
    },
    {
      "name": "spring-boot-multi-agent-startup-team",
      "description": "True multi-agent: 5 independent @Agent classes collaborate via A2A protocol",
      "category": "agent",
      "tags": [
        "spring-boot",
        "ai",
        "multi-agent",
        "a2a",
        "agent-card",
        "json-rpc",
        "gemini"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": true,
      "envVars": {
        "GEMINI_API_KEY": "Google Gemini API key (optional \u2014 demo mode without)"
      }
    },
    {
      "name": "spring-boot-dentist-agent",
      "description": "Dr. Molar \u2014 dental emergency agent with @Agent, slash commands, AI tools, Slack and Telegram",
      "category": "agent",
      "tags": [
        "spring-boot",
        "ai",
        "agent",
        "channels",
        "telegram",
        "slack",
        "commands",
        "tools"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {
        "LLM_API_KEY": "API key for your LLM provider (optional \u2014 demo mode without)",
        "TELEGRAM_BOT_TOKEN": "Telegram bot token from @BotFather",
        "TELEGRAM_WEBHOOK_SECRET": "Any random string for webhook verification",
        "SLACK_BOT_TOKEN": "Slack bot token (xoxb-...)",
        "SLACK_SIGNING_SECRET": "Slack app signing secret"
      }
    },
    {
      "name": "spring-boot-orchestration-demo",
      "description": "Support Desk \u2014 handoffs, approval gates, commands",
      "category": "agent",
      "tags": [
        "spring-boot",
        "ai",
        "orchestration",
        "handoff",
        "approval",
        "commands",
        "coordinator"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {
        "LLM_API_KEY": "API key for your LLM provider (optional \u2014 demo mode without)"
      }
    },
    {
      "name": "spring-boot-channels-chat",
      "description": "Omnichannel AI chat \u2014 Web, Telegram, Slack, Discord, WhatsApp, Messenger",
      "category": "ai",
      "tags": [
        "spring-boot",
        "ai",
        "channels",
        "telegram",
        "slack",
        "discord",
        "whatsapp",
        "messenger"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {
        "LLM_API_KEY": "API key for your LLM provider (optional \u2014 demo mode without)"
      }
    },
    {
      "name": "spring-boot-ai-chat",
      "description": "AI streaming chat \u2014 React useChat UI, WebTransport fallback, swap backend via one dependency",
      "category": "ai",
      "tags": [
        "spring-boot",
        "ai",
        "streaming",
        "gemini",
        "openai",
        "ollama",
        "spring-ai",
        "langchain4j",
        "adk",
        "embabel"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": true,
      "envVars": {
        "LLM_API_KEY": "API key for your LLM provider (Gemini, OpenAI, etc.)",
        "LLM_MODEL": "Model name (default: gemini-2.0-flash)",
        "LLM_BASE_URL": "API base URL (default: Gemini)"
      }
    },
    {
      "name": "spring-boot-ai-classroom",
      "description": "AI classroom \u2014 multiple clients share streaming AI responses",
      "category": "ai",
      "tags": [
        "spring-boot",
        "ai",
        "classroom",
        "broadcasting",
        "collaborative"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": true,
      "envVars": {
        "LLM_API_KEY": "API key for your LLM provider",
        "LLM_MODEL": "Model name (default: gemini-2.0-flash)"
      }
    },
    {
      "name": "spring-boot-ms-governance-chat",
      "description": "Chat gated by Microsoft Agent Governance Toolkit YAML policies (MS schema, verbatim)",
      "category": "governance",
      "tags": [
        "spring-boot",
        "ai",
        "governance",
        "policy",
        "ms-agent-os",
        "yaml",
        "interop"
      ],
      "port": 8090,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {}
    },
    {
      "name": "spring-boot-ai-tools",
      "description": "Enterprise AI starter \u2014 portable @AiTool calls, HITL approval, cost metering, audit listener",
      "category": "tools",
      "tags": [
        "spring-boot",
        "ai",
        "tools",
        "framework-agnostic"
      ],
      "port": 8090,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": true,
      "envVars": {
        "LLM_API_KEY": "API key for your LLM provider",
        "LLM_MODEL": "Model name"
      }
    },
    {
      "name": "spring-boot-rag-chat",
      "description": "RAG agent \u2014 chunked vector-store ingestion, @Agent tools for knowledge search, slash commands",
      "category": "agent",
      "tags": [
        "spring-boot",
        "ai",
        "rag",
        "vectorstore",
        "embeddings"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": true,
      "envVars": {
        "LLM_API_KEY": "API key for your LLM provider",
        "LLM_MODEL": "Model name"
      }
    },
    {
      "name": "spring-boot-mcp-server",
      "description": "MCP server \u2014 expose tools, resources, and prompts to AI agents",
      "category": "mcp",
      "tags": [
        "spring-boot",
        "mcp",
        "model-context-protocol",
        "tools",
        "resources"
      ],
      "port": 8083,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": true
    },
    {
      "name": "spring-boot-a2a-agent",
      "description": "Headless A2A agent \u2014 AI-powered skills discoverable via Agent Card",
      "category": "agent",
      "tags": [
        "spring-boot",
        "a2a",
        "agent-to-agent",
        "agent",
        "json-rpc",
        "headless"
      ],
      "port": 8084,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {
        "LLM_API_KEY": "API key for Gemini/OpenAI/Ollama (optional \u2014 demo mode without)"
      }
    },
    {
      "name": "spring-boot-agui-chat",
      "description": "AG-UI chat \u2014 streaming agent state to frontends via SSE (CopilotKit compatible)",
      "category": "agent",
      "tags": [
        "spring-boot",
        "ag-ui",
        "copilotkit",
        "sse",
        "streaming",
        "agent"
      ],
      "port": 8085,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": true
    },
    {
      "name": "spring-boot-otel-chat",
      "description": "Chat with OpenTelemetry tracing (Jaeger)",
      "category": "observability",
      "tags": [
        "spring-boot",
        "otel",
        "tracing",
        "jaeger"
      ],
      "port": 8084,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {
        "OTEL_EXPORTER_OTLP_ENDPOINT": "OTLP endpoint (default: http://localhost:4317)"
      }
    },
    {
      "name": "spring-boot-durable-sessions",
      "description": "Durable sessions \u2014 survive server restarts with SQLite",
      "category": "infrastructure",
      "tags": [
        "spring-boot",
        "sessions",
        "persistence",
        "sqlite"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false
    },
    {
      "name": "spring-boot-chat",
      "description": "Real-time WebSocket chat with Spring Boot",
      "category": "chat",
      "tags": [
        "spring-boot",
        "websocket",
        "chat"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": true
    },
    {
      "name": "quarkus-chat",
      "description": "Real-time WebSocket chat with Quarkus",
      "category": "chat",
      "tags": [
        "quarkus",
        "websocket",
        "chat"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "quarkus",
      "hasFrontend": true
    },
    {
      "name": "quarkus-ai-chat",
      "description": "Quarkus @AiEndpoint streaming via Quarkus LangChain4j",
      "category": "ai",
      "tags": [
        "quarkus",
        "websocket",
        "ai",
        "langchain4j",
        "streaming"
      ],
      "port": 18810,
      "runnable": true,
      "packaging": "quarkus",
      "hasFrontend": false
    },
    {
      "name": "embedded-jetty-websocket-chat",
      "description": "Embedded Jetty WebSocket chat (no framework)",
      "category": "chat",
      "tags": [
        "jetty",
        "websocket",
        "embedded",
        "standalone"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "executable-jar",
      "mainClass": "org.atmosphere.samples.chat.EmbeddedJettyWebSocketChat",
      "hasFrontend": true
    },
    {
      "name": "chat",
      "description": "Classic Atmosphere chat (WAR deployment)",
      "category": "chat",
      "tags": [
        "servlet",
        "websocket",
        "war"
      ],
      "port": 8080,
      "runnable": false,
      "packaging": "war",
      "hasFrontend": true,
      "note": "Requires a servlet container. Use 'spring-boot-chat' for standalone."
    },
    {
      "name": "grpc-chat",
      "description": "Chat over gRPC transport",
      "category": "chat",
      "tags": [
        "grpc",
        "transport"
      ],
      "port": 8080,
      "runnable": false,
      "packaging": "jar",
      "hasFrontend": false,
      "note": "Requires gRPC client. See sample README for details."
    },
    {
      "name": "spring-boot-coding-agent",
      "description": "Coding agent — Sandbox SPI + Git clone + AgentResumeHandle reattach",
      "category": "agent",
      "tags": [
        "spring-boot",
        "ai",
        "agent",
        "sandbox",
        "reattach"
      ],
      "port": 8081,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {
        "OPENAI_API_KEY": "API key for the LLM provider (optional — sample works without)"
      }
    },
    {
      "name": "spring-boot-guarded-email-agent",
      "description": "Plan-and-Verify (Meijer) — statically refuses unsafe LLM-emitted plans before any tool fires",
      "category": "governance",
      "tags": [
        "spring-boot",
        "ai",
        "governance",
        "verifier",
        "plan-and-verify"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {},
      "note": "Self-contained UI at src/main/resources/static/index.html (Spring-served, no Vite source tree). hasFrontend tracks the Vite convention used by spring-boot-ai-chat etc., not whether a UI exists."
    },
    {
      "name": "spring-boot-personal-assistant",
      "description": "Long-lived memory-bearing assistant: AgentState + AgentWorkspace + AgentIdentity + ProtocolBridge",
      "category": "agent",
      "tags": [
        "spring-boot",
        "ai",
        "agent",
        "workspace",
        "memory",
        "identity"
      ],
      "port": 8080,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {
        "OPENAI_API_KEY": "API key for the LLM provider (optional — demo mode without)"
      }
    },
    {
      "name": "spring-boot-reattach-harness",
      "description": "Deterministic harness for the mid-stream reattach contract (RunRegistry + RunEventReplayBuffer)",
      "category": "infrastructure",
      "tags": [
        "spring-boot",
        "ai",
        "reattach",
        "test-harness"
      ],
      "port": 8096,
      "runnable": true,
      "packaging": "spring-boot",
      "hasFrontend": false,
      "envVars": {},
      "note": "Test harness for the reattach contract — used by Playwright reattach.spec.ts; not a typical user starter."
    }
  ]
}