BoilerShelf Streaming Chatbot
A production-grade developer starter kit for high-concurrency, ultra-low-latency real-time LLM token streaming — the responsive ChatGPT-style experience where text appears token-by-token as it's generated, not all at once.
Core capabilities
- Server-Sent Events (SSE) streaming: standardized event lifecycle (
stream_start,token,metadata,error,stream_end). - Real-time client cancellation: a
RunManagertracks every active generation task — clicking "Stop" or closing the tab immediately aborts upstream LLM generation, preventing wasted token spend. - 5 LLM backends: OpenAI, Anthropic Claude, Google Gemini, Groq, and a built-in zero-cost Mock model for local development and CI without any API keys.
- Redis rate limiting: atomic IP-based fixed-window limiting with graceful fallback if Redis is unavailable.
Four tiers, two independent choices
Pick your database (MongoDB or PostgreSQL) and your auth level (NoAuth or WithAuth) — all four combinations ship the identical streaming engine:
- NoAuth tiers: a minimal 2-router backend, ideal for embedding into existing apps or internal tools.
- WithAuth tiers: adds full JWT authentication, RBAC, OTP email verification, Fernet-encrypted credential handling, and an admin dashboard with audit logs.
This is a pure text-streaming product — no voice, no document RAG. If you need a voice-in/voice-out assistant instead, see the Voice Chatbot product.
