spark
A local AI at your shell prompt.
Free and open source. Use it on an existing Mac, supported Linux machine or Windows with WSL.
Before installing, check the requirements and model sizes. Setup downloads an engine and model, updates your shell config and starts local services.
curl -fsSL https://github.com/forgewright-ai/spark/releases/latest/download/get | sh
Read the install steps before running this line.
Ask in words. Get the command.
Type ? and what you want. spark suggests a command in your line. Read it, then press Enter again to run it.
A command failed? Ask why.
After a command fails, press Esc s on an empty line for the reason. Press it again for a fix.
Ask a question.
Use spark chat to talk through a problem.
Give it a task.
spark do works through a task one command at a time. With --sandbox, it works in a copy first and asks before applying changes.
Install
Start on the computer you already use. Setup asks before adding shell keys and may need sudo for a package.
-
Get the basics.
Arch Linux:
sudo pacman -S --needed git curl python openssh
Debian 13, Ubuntu 24.04 or newer:
sudo apt-get update && sudo apt-get install -y git curl python3 openssh-client
Void Linux:
sudo xbps-install -Sy git curl python3
Fedora:
sudo dnf install -y git openssh-clients python3 curl
openSUSE Tumbleweed:
sudo zypper install -y git openssh-clients python3 curl
Any recent Mac:
xcode-select --install
In PowerShell:
wsl --install -d Ubuntu-24.04
Inside Ubuntu:
sudo apt-get update && sudo apt-get install -y git curl python3 openssh-client
-
Run one line.
curl -fsSL https://github.com/forgewright-ai/spark/releases/latest/download/get | sh -
Open a new shell and check.
exec $SHELL spark check
Try one safe question
After spark check, type ? how many files are here at your shell prompt and press Enter. A suggested command should appear in your line.
Read the command first. Press Ctrl-C to discard it, or press Enter again to run it. A command marked ! can delete data.
Need help? Ask a question. To report a bug, describe the steps without pasting keys, private files or raw logs.
Every option is in the install guide. Then try a first hour, or watch the lessons.
What leaves your machine
No account. No telemetry.
Your words go to the model server you choose, usually on this machine. If you connect another machine, traffic is plain HTTP unless you set up HTTPS; anyone on that network can read plain HTTP. spark downloads its engine and model; every release is signed.