Everything you need, nothing you don't
Sparkbot does everything ChatGPT does — but your conversations stay on your computer, always.
Completely private
Your chats never leave your computer. No company reads them, stores them, or uses them to train AI. What you type stays yours.
Chat with AI naturally
Ask questions, get help writing emails, plan a trip, or just have a conversation. Works with OpenAI, Anthropic, Google, or free local models with no API key needed.
It remembers you
Tell Sparkbot your name, your preferences, your routines — and it'll remember across every conversation, forever, on your own computer.
Read your files
Drop in a document, spreadsheet, or photo and ask Sparkbot to summarize it, answer questions about it, or help you edit it.
Reminders & web search
Ask it to remind you to take your medication, look something up on the internet, or check the weather — it can do all of that.
Custom AI assistants
Set up different AI personalities for different tasks — one for cooking help, one for writing, one for medical questions. Each stays focused on what you need.
New in v1.6.62: security maintenance
This update hardens chat, WebSocket, terminal, upload, and local setup behavior while keeping the public downloader aligned to the next desktop build.
Chat message fix
REST message creation no longer recurses, message search treats wildcard characters literally, and chat-user creation is limited to operator identities.
WebSocket cleanup
Chat and terminal WebSocket authentication paths now close database sessions on every exit path to avoid long-running connection leaks.
Terminal sessions bounded
Closed workstation terminal sessions are removed from memory, and rate-limit buckets for login and operator PIN attempts are pruned over time.
Safer local setup
Local JWT defaults no longer regenerate on every restart, production still rejects unsafe secrets, and setup now generates the local Postgres password.
Upload serving tightened
File serving reads only the first bytes needed for MIME detection instead of loading the whole upload before returning the response.
Downloader refreshed
The public download page and package metadata now point at the v1.6.62 desktop build line.
Command Center
Spine Ops is now the operator-facing Command Center with Room Persona first, shared top navigation, and System Health, Computer Control, Token Guardian, and Task Guardian surfaced there.
How to install Sparkbot
It takes about 2 minutes. If you can install an app on your phone, you can do this.
Click the big purple "Download for Windows" button above
Your browser will download a file called Sparkbot.Local_1.6.62_x64-setup.exe. This is the installer. It usually arrives in less than a minute.
Find the downloaded file and open it
Look at the bottom of your browser for the downloaded file, or check your Downloads folder. Double-click the file named Sparkbot.Local_1.6.62_x64-setup.exe to start installing.
Handle the Windows security warning (don't worry — see below)
Windows may show a blue or grey warning screen. This is normal for new software and does not mean anything is wrong. Scroll down for a step-by-step picture of exactly what to click.
Follow the installer — it only takes a moment
Click Next (or Install) on any screens that appear. When it's done, Sparkbot will appear in your Start Menu like any other app.
Open Sparkbot and connect your AI
Find Sparkbot in your Start Menu and open it. A setup panel will appear automatically. The easiest way to get started is with OpenRouter — it's free to sign up and gives you access to many AI models. Just create a free account at openrouter.ai, copy your API key, and paste it into Sparkbot. You can also use a free local AI that runs entirely on your computer with no account needed — or connect OpenAI, Anthropic, or Google. All of this can be changed any time.
About the Windows warning screen
Windows shows this for any new software. Here's exactly what to do — step by step.
Windows protected your PC
Microsoft Defender SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk.
- When the blue screen appears, look for the small text link that says "More info" — click it. (It's usually in the lower-left area of the blue box.)
- After clicking "More info", a new button will appear at the bottom that says "Run anyway" — click that.
- The installer will now start normally. Continue with the installation as usual.
Questions & answers
Plain English answers to things people usually wonder about.
After you install and open Sparkbot, a setup panel will pop up automatically. The easiest way to get your AI working is through OpenRouter — a free service that gives you access to many AI models.
Here's what to do: 1) Go to openrouter.ai in your web browser and create a free account. 2) Once logged in, go to your account settings and find "API Keys". Create a new key — it's a long string of letters and numbers. 3) Copy that key and paste it into Sparkbot when it asks. That's it! You're ready to chat.
An "API key" is just a password that lets Sparkbot talk to the AI service on your behalf. You don't need to understand how it works — just copy and paste it. OpenRouter's free tier includes access to several capable AI models at no cost.
Yes, it is safe. Sparkbot is open source software, which means anyone in the world can read its entire code and verify there is nothing harmful in it. You can find the full source code on GitHub at the link in the footer.
The Windows warning you see is called SmartScreen — it appears automatically for any software that hasn't been downloaded by millions of people yet. It's a precaution from Microsoft, not a sign that something is wrong. New software from even well-known developers triggers this warning.
Sparkbot itself is completely free, forever. There is no trial period, no subscription, and no credit card required.
The AI "brain" inside Sparkbot can be either free (using a local AI model that runs on your computer with no internet needed) or paid (using a service like OpenAI or Anthropic, which charge by how much you use). Most people start with the free local option, which works great for everyday questions. You choose — Sparkbot never charges you directly.
It depends on which AI option you choose. If you use a local AI model (the free option), Sparkbot works completely offline — no internet required at all after the initial setup download.
If you connect it to an online AI service like OpenAI or Anthropic, then it needs internet to talk to those services. But even then, your conversation history stays on your computer — only the actual question you're asking gets sent over the internet, just like when you search Google.
Think of AI as a very well-read assistant that has studied an enormous amount of text — books, websites, encyclopedias, instruction manuals — and can answer questions about almost anything in plain, conversational language.
You type a question or request in normal sentences, and it types back a helpful answer. You don't need to learn any special commands or technical language. Just talk to it the same way you'd talk to a knowledgeable friend. If you've ever used Google to look something up, you can use Sparkbot.
No. Your conversations are stored only on your computer, in a folder that belongs to you. No one at Sparkbot sees them. There are no servers receiving your chat history.
If you choose to use a paid AI service like OpenAI, those services do receive the text of your question in order to answer it — the same way a search engine receives what you type to give you results. But Sparkbot itself never transmits or stores your chats anywhere other than your own machine.
ChatGPT and Claude are websites run by big companies — you visit their site, create an account, and your conversations are stored on their servers. They may use those conversations to improve their systems, and you need to pay monthly for the full features.
Sparkbot runs on your own computer. Your conversations belong only to you. There's no account to create, no monthly bill, and the app works even without internet. Think of it as having your own personal AI assistant that you own outright, rather than renting time with someone else's.
Any Windows 10 or Windows 11 computer made in the last 5–6 years will work fine. You don't need a gaming computer or anything fancy.
If you want to use a free local AI model (no internet required), having 8 GB of RAM helps, though smaller models work on 4 GB. If you connect Sparkbot to an online AI service like OpenAI, even an older computer will work well because the heavy thinking happens on their servers.
You can open a support request on GitHub (the link is in the footer). The community there is friendly and helpful. Just describe what happened and someone will get back to you — usually within a day.
You can also uninstall Sparkbot at any time from Windows Settings → Apps → Installed Apps, exactly like removing any other program. It won't leave anything behind.
Most people use the desktop download above. The section below is for IT professionals and developers only.
Self-Host on Your Own Server
Run Sparkbot on a home server, NAS, or cloud VM. Clone the repo, run one command, then follow the setup wizard.
Linux / Server Install
Run on Ubuntu, Debian, a home server, NAS, or cloud VM. The wizard handles Docker Compose v1/v2, provider keys, model defaults, bind mode, and port fallback.
git clone https://github.com/armpit-symphony/Sparkbot.git
cd Sparkbot
Local machine: bash scripts/sparkbot-start.sh --local
Cloud server/VPS: bash scripts/sparkbot-start.sh --server
bash scripts/sparkbot-start.sh --install-docker-plugins if Ubuntu is missing buildx/Compose plugins
SPARKBOT_FRONTEND_PORT=3001 bash scripts/sparkbot-start.sh --server if you want a specific port
export OPENAI_API_KEY="sk-..." && bash scripts/sparkbot-start.sh --server --from-env for no-prompt SSH key import
export SPARKBOT_PASSPHRASE="long-private-passphrase" can seed server auth for --from-env
bash scripts/sparkbot-start.sh --server --show-passphrase-input for visible passphrase troubleshooting
bash scripts/sparkbot-start.sh --server --dry-run-setup to validate prompts without starting Docker
bash scripts/sparkbot-start.sh --server --hide-input if you prefer hidden provider-key entry
OpenAI Codex subscription on SSH servers: codex login --device-auth, then run docker compose -f compose.local.yml -f compose.codex.yml up -d --build
Set SPARKBOT_CODEX_AUTH_FILE=/absolute/path/to/auth.json first if Codex auth is not at $HOME/.codex/auth.json
The launcher starts detached, prompts for a server passphrase, prints the actual URL, and is the normal install path. Raw Docker Compose is advanced only.
CLI Setup
Configure providers from a terminal without opening env files. If Sparkbot is not running yet, CLI setup falls back to the local server wizard.
python3 sparkbot-cli.py --setup
python3 sparkbot-cli.py
Use this when you want the same guided provider/model setup from SSH or a local terminal.
Requires Docker and Docker Compose · Source on GitHub
Ready to try it?
Free. Private. Yours. Download takes less than a minute.
Free Download Download for Windows