spark 1.37 . by forgewright-ai

Own your AI.

A private AI on a machine you own. No account, no cloud, no subscriptions or paid tokens. Just one line, and download the right model for your hardware.

curl -fsSL https://github.com/forgewright-ai/spark/releases/latest/download/get | sh
~ > files bigger than 1G modified this week?
* Finds files >1G modified in last 7 days               <- the hint, above the prompt
~ > find . -type f -size +1G -mtime -7                  <- the command, in your line

1. Choose your OS

An old laptop, a mini PC, the Mac on your desk.

Arch Linux:

sudo pacman -S --needed git curl python

Debian 13, Ubuntu 24.04 or newer:

sudo apt-get update && sudo apt-get install -y git curl python3

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

Then one line:

curl -fsSL https://github.com/forgewright-ai/spark/releases/latest/download/get | sh

Open a new shell:

exec $SHELL
spark check

Details: INSTALL.md.

2. spark is live

All of it here, none of it anywhere else.

The tour: a first hour, twelve small things to try.

~ > spark chat
chat -- /help, Ctrl-D or /q ends
chat> write a haiku about a machine that thinks for itself
* A hum in the dark,
  no wire runs to the city:
  the answer is here.

chat>
~ > tar -xzf notes.tgz 2>&1 | explain
* tar says this is not a gzip archive: the file was renamed,
  not converted. See what it really is, then unpack it:
~ > file notes.tgz
~ > spark @draft.md is the title too long?
* Yes: nine words where four would land. Keep "The Quiet
  Machine" and let the first paragraph carry the rest.
  • spark <words>ask anything, the answer streams back
  • spark do <words>run a task, confirming each command
  • spark model listthe models spark can serve, with licenses
  • spark forge --print-urlget the address to access spark from the browser on your LAN
  • spark client URLconfigure another machine to access your local AI
  • spark on/offpause or resume spark at the prompt

More: cheatsheet . models.

3. spark apps

Use spark inside the tools you already use.

Install the micro plugin:

git clone https://github.com/forgewright-ai/spark-micro ~/.config/micro/plug/spark

Add "Alt-s": "lua:spark.prompt" to ~/.config/micro/bindings.json. Press Alt-s to complete, rewrite, or ask about your text.

~ > micro draft.md then Alt-s
spark> ? is the ending earned
* Not yet: "she turned back" comes with nothing before it that
  would make her. One scene of doubt, earlier, would earn it.

Details: spark-micro . spark-neovim . spark-vim . spark-helix . spark-nano . spark-w3m . spark-newsboat.

Everything runs on your machine and local network.

Private

No telemetry, no analytics, no account.

Open

MIT. Licenses named in CREDITS.md.

Free

No subscriptions, no paid tokens.