Welcome
Atmosphere is a transport-agnostic real-time framework for the JVM. Write to a Broadcaster, and the framework delivers to every subscriber — whether they’re on WebTransport over HTTP/3, WebSocket, SSE, long-polling, or gRPC. Use @ManagedService for classic real-time (chat, dashboards, notifications, collaboration), or @Agent for AI-powered agents with tool calling, conversation memory, and multi-protocol exposure (MCP, A2A, AG-UI).
Because Atmosphere owns the broadcaster end-to-end, the framework does things a pure orchestration layer cannot: rewrites PII tokens in-flight before bytes reach the client, blocks outbound @Prompt dispatch when a tenant hits its cost ceiling, replays mid-stream events after a client reconnect via X-Atmosphere-Run-Id, stamps tenant / customer / revenue tags onto every log record for observability joins (Dynatrace / Datadog / OTel), and grounds every agent turn in deterministic FactResolver facts so the model stops making up the user’s plan tier or the current time. Admin writes run a triple-gate (feature flag → Principal → ControlAuthorizer) with an opt-in read-side gate for multi-tenant deployments.
Same framework, same transports, same clustering — you choose how much AI you need.
How to Use This Documentation
Section titled “How to Use This Documentation”Want a running app now? Install the CLI and run a sample in 30 seconds: Install & Run.
New to Atmosphere? Start with the Tutorial — a 24-chapter guide that builds your understanding from first principles to production deployment.
Looking for a specific feature? Use the Reference section for API details on the core runtime, rooms, AI, MCP, and more.
Integrating with a framework? The Integrations section covers Spring Boot 4.0, Quarkus 3.31, and AI framework adapters.
Quick Links
Section titled “Quick Links”Real-Time Core
Section titled “Real-Time Core”| What you want | Where to go |
|---|---|
| Run a sample in 30 seconds | Install & Run (CLI) |
| Build your first app | Chapter 2: Getting Started |
@ManagedService deep dive | Chapter 3 |
| Transports (WebSocket, SSE, gRPC) | Chapter 4 |
| Broadcaster & pub/sub | Chapter 5 |
| Rooms & presence | Chapter 6 |
| React/Vue/Svelte hooks | atmosphere.js |
| Clustering (Redis/Kafka) | Chapter 16 |
AI & Agents
Section titled “AI & Agents”| What you want | Where to go |
|---|---|
@Agent annotation | @Agent |
| Multi-agent orchestration | @Coordinator |
| AI/LLM streaming | Chapter 9: @AiEndpoint |
| Tool calling | Chapter 10: @AiTool |
| Guardrails (PII, drift, cost ceiling) | Chapter 12: AI Filters |
| MCP server | Chapter 13 |
Trust phases (PermissionMode) | Chapter 25 |
| Business-outcome tagging (MDC) | Chapter 27 |
Grounded facts (FactResolver) | Chapter 28 |
| Agent-to-agent flow viewer | Chapter 29 |
| Testing AI agents | AI Testing |
Deployment
Section titled “Deployment”| What you want | Where to go |
|---|---|
| Spring Boot auto-config | Spring Boot Reference |
| Quarkus extension | Quarkus Reference |
| Multi-channel (Slack, Telegram, …) | Chapter 23 |
Version
Section titled “Version”This documentation covers the Atmosphere 4.0.x release line with JDK 21+, Spring Boot 4.0.5 (Spring Framework 6.2.8), and Quarkus 3.31.3. See What’s New for a highlights reel of changes since the 4.0.0 release.