https://github.com/thunderbird/thunderbolt
AI You Control: Choose your models. Own your data. Eliminate vendor lock-in.
https://github.com/thunderbird/thunderbolt
ai ai-agents llms on-device-ai
Last synced: 24 days ago
JSON representation
AI You Control: Choose your models. Own your data. Eliminate vendor lock-in.
- Host: GitHub
- URL: https://github.com/thunderbird/thunderbolt
- Owner: thunderbird
- License: mpl-2.0
- Created: 2025-07-23T18:54:20.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-04-19T05:44:27.000Z (about 2 months ago)
- Last Synced: 2026-04-19T07:35:24.324Z (about 2 months ago)
- Topics: ai, ai-agents, llms, on-device-ai
- Language: TypeScript
- Homepage: https://thunderbolt.io
- Size: 16.3 MB
- Stars: 1,754
- Watchers: 8
- Forks: 90
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Roadmap: docs/roadmap.md
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-github-projects - thunderbolt - AI You Control: Choose your models. Own your data. Eliminate vendor lock-in. ⭐4,676 `TypeScript` 🔥 (🤖 AI & Machine Learning)
- AiTreasureBox - thunderbird/thunderbolt - 05-09_4529_2](https://img.shields.io/github/stars/thunderbird/thunderbolt.svg)|AI You Control: Choose your models. Own your data. Eliminate vendor lock-in.| (Repos)
README
# Thunderbolt [](https://github.com/thunderbird/thunderbolt/actions/workflows/ci.yml)
**AI You Control: Choose your models. Own your data. Eliminate vendor lock-in.**
> [!IMPORTANT]
> ⚠️ **We are excited about the amount of interest Thunderbolt has been getting and want to clarify that it is still early and under active development**. Currently, we are targeting enterprise customers that want to deploy it on-prem. We encourage you to self-host it and try it out, but there are a few caveats we are still working on:
>
> - While we eventually plan to make Thunderbolt fully offline-first, it currently depends on authentication and search functionality (though you can disable search on the integrations screen in the app). You can [deploy your own backend with Docker](./deploy/README.md) and sign up in order to test it locally.
> - You’ll need to add your own model providers - we don’t yet have a public inference endpoint. We recommend using Thunderbolt with [Ollama](https://ollama.com) or [llama.cpp](https://github.com/ggml-org/llama.cpp) if you want free local inference, or you can add API keys for any OpenAI-compatible model provider in the settings.
Thunderbolt is an open-source, cross-platform AI client that can be deployed on-prem anywhere.
- 🌐 Available on all major desktop and mobile platforms: web, iOS, Android, Mac, Linux, and Windows.
- 🧠 Compatible with frontier, local, and on-prem models.
- 🙋 Enterprise features, support, and FDEs available.
**Thunderbolt is under active development, currently undergoing a security audit, and preparing for enterprise production readiness.**
## Get Started Locally
```sh
make doctor # verify your tools — prints exact install commands for anything missing
make setup # install frontend + backend dependencies, wire up agent symlinks
make up # start Postgres + PowerSync in Docker
make run # start the backend (:8000) and frontend (:1420)
```
For self-hosting with Docker Compose or Kubernetes, see [`deploy/README.md`](./deploy/README.md). For full dev-environment details, see [`docs/development/quick-start.md`](./docs/development/quick-start.md).
## Need Help?
Found a bug? Have an idea?
- We're actively working on our docs, community, and roadmap. For now, the best way to get in touch is to [File an issue](https://github.com/thunderbird/thunderbolt/issues).
## Contributing
We welcome contributions from everyone.
- **Development**: The [development guide](./docs/development/quick-start.md) will help you get started.
- Make sure to check out the [Mozilla Community Participation Guidelines](https://www.mozilla.org/about/governance/policies/participation/).
## Documentation
- [FAQ](./docs/faq.md) - Frequently asked questions
- [Deployment](./deploy/README.md) - Self-host with Docker Compose or Kubernetes
- [Development](./docs/development/quick-start.md) - Quick start, setup, and testing
- [Architecture](./docs/architecture/README.md) - System architecture and diagrams
- [Storybook](./docs/dev-tooling/storybook.md) - Build, test, and document components
- [Vite Bundle Analyzer](./docs/dev-tooling/vite-bundle-analyzer.md) - Analyze frontend bundle size
- [Tauri Signing Keys](./docs/features/tauri-signing-keys.md) - Generate and manage signing keys for releases
- [Release Process](./RELEASE.md) - Instructions for creating and publishing new releases
- [Telemetry](./TELEMETRY.md) - Information about data collection and privacy policy
## Code of Conduct
Please read our [Code of Conduct](./CODE_OF_CONDUCT.md). All participants in the Thunderbolt community agree to follow these guidelines and [Mozilla's Community Participation Guidelines](https://www.mozilla.org/about/governance/policies/participation/).
## Security
If you discover a security vulnerability, please report it responsibly via our [vulnerability reporting form](https://github.com/thunderbird/thunderbolt/security/advisories/new). Please do **not** file public GitHub issues for security vulnerabilities.
## License
Thunderbolt is licensed under the [Mozilla Public License 2.0](./LICENSE).