whatisgithub

What is thunderbolt?

thunderbird/thunderbolt — explained in plain English

Analysis updated 2026-06-26

4,562TypeScriptAudience · ops devopsComplexity · 4/5LicenseSetup · hard

In one sentence

Thunderbolt is an open-source AI chat app from the Thunderbird team that connects to any AI model you choose, runs on your own servers, and keeps your data under your control instead of a third-party cloud.

Mindmap

mindmap
  root((thunderbolt))
    What it does
      AI chat client
      Self-hosted
      Multi-model
    Platforms
      Web
      Mac and Windows
      iOS and Android
    AI Connections
      Local Ollama
      OpenAI compatible
      On-premises servers
    Deploy
      Docker Compose
      Kubernetes
      Make commands
Click or tap to explore — scroll the page freely

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

Deploy a private AI chat platform for your company that runs entirely on your own servers with no data leaving your network

USE CASE 2

Connect your team to local AI models running on-premises using tools like Ollama or llama.cpp

USE CASE 3

Run an AI assistant across web, Mac, Windows, Linux, iOS, and Android using your own API keys with no vendor lock-in

What is it built with?

TypeScriptDockerKubernetesOllama

How does it compare?

thunderbird/thunderboltget-convex/chefremaxjs/remax
Stars4,5624,5664,568
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardmoderate
Complexity4/54/53/5
Audienceops devopsvibe coderdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Docker for the database and sync service, the team warns it is not yet production-ready and is targeting enterprise customers first.

You can use and modify the code, if you distribute modified versions you must share the changes under the same license terms.

So what is it?

Thunderbolt is an open-source AI chat client from the team behind the Thunderbird email application. Its core idea is that you should be able to pick which AI models you talk to, keep your data under your own control, and avoid being locked into any single AI provider. It is designed mainly for companies that want to run their own AI setup on their own servers rather than relying on cloud services. The app runs on web, Mac, Windows, Linux, iOS, and Android. You connect it to AI models of your choosing: local models running on your own machine via tools like Ollama or llama.cpp, private on-premises servers, or any cloud AI provider that is compatible with the OpenAI API format. You add your own API keys or point it at your own server, there is no built-in inference endpoint provided by the project itself. To get it running locally, the README describes a short sequence of make commands: one to verify your tools are installed, one to install dependencies, one to start a database and a sync service in Docker, and one to start the backend and frontend. For running it in production, the project provides Docker Compose and Kubernetes configuration files. The README notes that it currently requires internet access for authentication and optional search features, though both can be configured or disabled. The project is still in early development and was undergoing a security audit at the time of writing. The README explicitly cautions that it is not yet production-ready and that the team is prioritizing enterprise customers who want on-premises deployment. Community contributions are welcome, and bugs or feature requests go through GitHub issues. Thunderbolt is licensed under the Mozilla Public License 2.0.

Copy-paste prompts

Prompt 1
Show me how to set up Thunderbolt locally using the make commands in the README to start the database, sync service, backend, and frontend
Prompt 2
How do I connect Thunderbolt to a local Ollama instance running Llama 3 instead of a cloud AI provider?
Prompt 3
Generate a Docker Compose configuration for deploying Thunderbolt in production pointing at my own on-premises AI server
Prompt 4
How do I add my own API key to Thunderbolt so users on my self-hosted instance can chat with an OpenAI-compatible model?

Frequently asked questions

What is thunderbolt?

Thunderbolt is an open-source AI chat app from the Thunderbird team that connects to any AI model you choose, runs on your own servers, and keeps your data under your control instead of a third-party cloud.

What language is thunderbolt written in?

Mainly TypeScript. The stack also includes TypeScript, Docker, Kubernetes.

What license does thunderbolt use?

You can use and modify the code, if you distribute modified versions you must share the changes under the same license terms.

How hard is thunderbolt to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is thunderbolt for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.