âš¡ Sparkbot
Free & Open Source  Â·  v1.6.62

Your own AI,
on your computer

Chat with a powerful AI assistant that lives entirely on your machine. No cloud. No monthly fee. No account. Just download and go.

⚠️ Windows will show a blue SmartScreen warning

This happens for every new open-source app that hasn't hit millions of downloads yet. It is not a virus — here's exactly what to click:

  1. Click "More info" (small link, lower-left of the blue dialog)
  2. Click "Run anyway" — the installer will start normally

Version 1.6.62  Â·  Windows 10 & 11  Â·  64-bit  Â·  Free forever

This page checks GitHub for the latest stable desktop release automatically. If the button does not start a download, open All Releases and choose the Windows file that ends in _x64-setup.exe.

100% private — nothing leaves your PC
No subscription, no hidden fees
Open source

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.

The Codex Sub provider is the right route when you want Sparkbot to use your ChatGPT plan through Codex CLI without pasting an OpenAI Platform key.


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.

⚠️
You'll probably see this blue screen — don't panic
It's called "Windows SmartScreen" and it appears for any software that hasn't built up millions of downloads yet.
  • 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.

Guided setup

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.

Terminal friendly

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