whatisgithub

What is turbostream?

turboline-ai/turbostream — explained in plain English

Analysis updated 2026-05-18

16GoAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

TurboStream is a Go backend that streams real-time data over WebSocket and REST APIs while letting you query it in natural language through any of seven LLM providers.

Mindmap

mindmap
  root((TurboStream))
    What it does
      Real-time data streaming
      LLM-powered analysis
      Feed marketplace
      Multi-provider LLM support
    Tech stack
      Go
      MongoDB
      WebSocket
      Docker
    Use cases
      Live data dashboards
      Streaming AI queries
      Feed subscriptions
    Audience
      Backend developers
      Data streaming teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a real-time dashboard that lets users ask an AI natural-language questions about live data feeds.

USE CASE 2

Publish or subscribe to data feeds through TurboStream's built-in marketplace with isolated per-topic AI context.

USE CASE 3

Swap between LLM providers like Anthropic, OpenAI, or a local Ollama model without changing application code.

What is it built with?

GoMongoDBWebSocketDocker

How does it compare?

turboline-ai/turbostreamhome-operations/flatesrijanmukherjee/gomupdf
Stars161616
LanguageGoGoGo
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a MongoDB connection string and at least one LLM provider API key configured via environment variables.

Mozilla Public License 2.0, you can use and modify the code, but changes to MPL-licensed files must be shared if you distribute them.

So what is it?

TurboStream is a Go based backend server designed to connect real-time data streams to AI language models, letting you query and analyze fast-moving data with natural-language questions. Think of it as a bridge: data flows in continuously, and you can ask an AI what is happening right now and get a live answer. The server exposes REST API endpoints and WebSocket connections, with WebSocket being a protocol that keeps a persistent, two-way connection open between client and server, so data and AI responses can arrive in real time without repeatedly opening new connections. It supports seven different AI providers out of the box, including Anthropic, OpenAI, Google Gemini, Mistral, xAI, and a local option via Ollama, using a bring your own model approach where you supply your own API key for whichever provider you prefer. Data is organized into feeds, which you can publish to or subscribe to through a built-in marketplace. Each feed can have its own isolated AI context through topic routing, so a feed tracking one asset does not bleed context into another. The server also uses a compact data format called TSLN that the README says reduces token usage by 40 to 60 percent, helping keep AI API costs down when analyzing high frequency streams. User accounts are protected with JWT-based authentication, a standard token system for secure logins, plus optional two-factor authentication. The project uses MongoDB as its database and can be deployed with Docker or on Railway. A companion terminal UI client is available in a separate repository, and a commercial web frontend is offered on top of the open-source backend. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Show me how to set up TurboStream locally with MongoDB and an Anthropic API key.
Prompt 2
How do I connect to TurboStream's WebSocket endpoint to stream real-time LLM responses?
Prompt 3
Explain how TurboStream's topic routing keeps AI context isolated between different data feeds.
Prompt 4
Write a script that publishes a data feed to TurboStream's marketplace and queries it via /api/llm/query.

Frequently asked questions

What is turbostream?

TurboStream is a Go backend that streams real-time data over WebSocket and REST APIs while letting you query it in natural language through any of seven LLM providers.

What language is turbostream written in?

Mainly Go. The stack also includes Go, MongoDB, WebSocket.

What license does turbostream use?

Mozilla Public License 2.0, you can use and modify the code, but changes to MPL-licensed files must be shared if you distribute them.

How hard is turbostream to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is turbostream for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.