개요
Thunderbolt는 오픈 소스 크로스 플랫폼 AI 클라이언트로, 사용자가 자유롭게 모델을 선택하고 데이터를 소유하며 공급업체 종속을 제거할 수 있습니다. 데스크톱과 모바일을 지원하며 로컬 배포가 가능합니다.
README 미리보기
# Thunderbolt [](https://github.com/thunderbird/thunderbolt/actions/workflows/ci.yml)\n\n**AI You Control: Choose your models. Own your data. Eliminate vendor lock-in.**\n\n\n\n> [!IMPORTANT]\n> ⚠️ **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:\n>\n> - 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.\n> - 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.\n\nThunderbolt is an open-source, cross-platform AI client that can be deployed on-prem anywhere.\n\n- 🌐 Available on all major desktop and mobile platforms: web, iOS, Android, Mac, Linux, and Windows.\n- 🧠 Compatible with frontier, local, and on-prem models.\n- 🙋 Enterprise features, support, and FDEs available.\n\n**Thunderbolt is under active development, currently undergoing a security audit, and preparing for enterprise production readiness.**\n\n## Get Started Locally\n\n```sh\nmake doctor # verify your tools — prints exact install commands for anything missing\nmake setup # install frontend + backend dependencies, wire up agent symlinks\nmake up # start Postgres + PowerSync in Docker\nmake run # start the backend (:8000) and frontend (:1420)\n```\n\nFor self-hosting with Docker C
FAQ (5)
informationalThunderbolt가 self-hosted instances에서 기본적으로 telemetry를 수집하나요?
아니요, self-hosted/OIDC 배포의 경우 telemetry가 기본적으로 비활성화되어 있습니다. Consumer/cloud 배포는 여전히 telemetry가 기본적으로 활성화되어 있습니다. 이 변경 사항은 PR #714에서 구현되었습니다.
문제 해결Ubuntu에서 Tauri 앱을 빌드할 때 'javascriptcoregtk-4.1 not found' 오류를 해결하는 방법은?
Tauri의 Linux 시스템 종속성을 설치하세요:
sudo apt install libwebkit2gtk-4.1-dev libjavascriptcoregtk-4.1-dev \
build-essential curl wget file libxdo-dev libssl-dev \
libayatana-appindicator3-dev librsvg2-dev libsoup-3.0-dev
다른 배포판의 경우 Tauri의 prerequisites (https://v2.tauri.app/start/prerequisites/#linux)를 참조하세요. 또한 sccache가 설치되어 있는지 확인하세요 (cargo install sccache).
문제 해결자체 호스팅 Docker 배포에서 OIDC 로그인 후 콜백이 성공했음에도 불구하고 401 오류가 발생하는 이유는 무엇인가요?
이는 OIDC 인증 모드에서 콜백 후 Bearer 토큰을 유지하지 못하는 알려진 문제였습니다. PR #782에서 세션 쿠키 인증으로 전환하여 수정되었습니다. 배포를 업그레이드하고 환경 변수 VITE_AUTH_MODE를 'oidc'에서 'sso'로 변경하십시오. 또한 Identity Provider(예: Keycloak)를 업데이트하여 새로운 callback URL을 반영하십시오. 그러면 로그인 후 모든 인증된 요청이 즉시 작동합니다.
문제 해결Postgres 컨테이너에서 'these Docker images are configured to store database data in a format which is compatible with pg_ctlcluster' 오류를 해결하는 방법?
docker-compose.yml을 업데이트하세요: 볼륨 마운트를 /var/lib/postgresql/data에서 /var/lib/postgresql로 변경하십시오. 예를 들어, '- postgres_data:/var/lib/postgresql/data'를 '- postgres_data:/var/lib/postgresql'로 바꾸십시오. 또는 Postgres 이미지를 postgres:17-alpine으로 고정하여 이전 데이터 레이아웃을 유지하십시오.
문제 해결Kubernetes에서 Thunderbolt v0.1.91을 배포한 후 backend pod가 시작되지 않는 이유는 무엇인가요?
v0.1.91에서의 백엔드 배포에 BETTER_AUTH_SECRET 환경 변수가 누락되어, 파드가 시작 시 충돌합니다. 이 문제는 PR #548에서 수정되었으며, 향후 릴리스에 포함될 예정입니다. 해결 방법으로, 백엔드 배포 YAML에 BETTER_AUTH_SECRET 변수를 수동으로 추가하십시오.