Repository navigation
Releases
rigspark v3.1.2
RigSpark now lives at https://github.com/rigspark/rigspark. 3.1.1 reached
crates.io, but its downloads and desktop update were never published, so
3.1.2 is the first app release with the 3.1.1 changes below.
Changes
- New home:
rigspark/rigspark. Update checks, the desktop updater,
catalog updates, model requests and every link now use the new address.
Container images from this release are atghcr.io/rigspark/rigspark.
Apps older than 3.1.2 may stop showing "Update to …" on their own; use
Runtime › Check for updates in the desktop app, or download 3.1.2 from the
releases page.
Fixes
- A test that compared a path with forward slashes failed on Windows and
stopped the 3.1.1 release.
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedDesktop: download RigSpark_aarch64.dmg (Apple Silicon), RigSpark_x86_64.dmg (Intel Mac) or RigSpark_x64-setup.exe (Windows). The Mac app is signed with a Developer ID and notarized by Apple, so it opens like any other app.
Archives are unsigned. Verify downloads against SHA256SUMS and each .sha256 file.
rigspark v3.1.0
Features
- First-run notice. The GUI and desktop app open with a short notice that
states, in bold, the MIT licence terms, the "as is" warranty disclaimer,
that each model's licence and every generated output are the user's
responsibility, that the licence covers the code and not the RigSpark name
or logo, and that data stays on the device. It is shown until confirmed and
can be reopened from Runtime › Terms and licences. - Image chat makes the shape you need, in several versions. The
composer's Image mode picks thumbnail (16:9), wallpaper (9:16) or square and
1, 2 or 4 versions, each on its own seed; keep a seed to steer one picture.
Results download, copy to the clipboard, or go to a connected app (Canva,
Figma, a file store) through the chat and its approvals; RigSpark does not
re-implement editors. Generation jobs andrigspark generate --aspecttake
square,landscapeorportraitand report their seed; time per picture
is measured, never estimated. - Voice in the workspace (Community Edition). Models gains a Voice
tab: a curated catalog of speak models (kokoro-82m, chatterbox via
mlx-audio on Apple Silicon) and listen models (Whisper large-v3-turbo q8_0,
small q8_0 and base.en via whisper.cpp, pinned and SHA-256 verified), each
with a memory-only fit and its licence. Chat can speak replies, read any
reply aloud, take dictation from the microphone, and a new Voice mode
writes a script with the text model and reads it, or reads your exact
text, with an inline player and WAV download. Any loopback server with
OpenAI's audio endpoints can be attached instead. - Runtime view revamp. A live memory bar shows what voice models take
next to everything else, voice engines show their state, endpoint and stop
control, and voice settings cover spoken replies, microphone, audio output
and attaching a server.
Changes
- A quieter composer. Reply mode (Text, Image, Video, Voice), image shape
and versions, voice options and Speak replies now sit behind the +
button. A non-text mode shows as one chip ("Image · Thumbnail 16:9 · 4
versions") that reopens the menu, with × back to text. - Menu bar icon is a one-hood macOS template image that follows light and
dark menu bars, so RigSpark and RigSpark Crew are easy to tell apart. The
Dock icon is unchanged. - Contributor guide.
CONTRIBUTING.mdand a pull request template cover
the MIT licence of contributions, DCO sign-off, setup, the checks CI runs and
the house rules.
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedDesktop: download RigSpark_aarch64.dmg (Apple Silicon), RigSpark_x86_64.dmg (Intel Mac) or RigSpark_x64-setup.exe (Windows). The Mac app is signed with a Developer ID and notarized by Apple, so it opens like any other app.
Archives are unsigned. Verify downloads against SHA256SUMS and each .sha256 file.
rigspark v3.0.8
Features
- llama.cpp replies carry the server's own timings.
ChatResult.timings
holds what llama-server measured for that reply: prompt and generated tokens,
their milliseconds, cached prompt tokens and speculative draft tokens
accepted.prompt_tokens_per_second()andgenerated_tokens_per_second()
give exact speeds, with no client-side estimate. Other backends leave it
empty. - KV slots can be saved, restored and erased. A llama.cpp server rigspark
starts gets a privatekv-slots/directory beside its state file
(--slot-save-path).ChatInput.slotpins a request to a slot (id_slot,
with prompt caching), andkv_slot_with_configsaves a slot's KV cache to a
named file, restores it into any slot, or erases it. That frees a slot during
a long pause such as a tool call and brings the conversation back without
re-reading the prompt.- Slot names are 1 to 64 letters, digits,
-or_; slots are 0 to 15. - The server is re-identified before and after each slot action, as for chat.
- Slot names are 1 to 64 letters, digits,
Changes
- The website moved to its own repository. The www.rigspark.si source
(site/) and its Pages deploy now live in the privaterigspark-webrepo,
with their history. The brand kit the README, GUI and design kit use moved
fromsite/brand/toassets/brand/.cargo catalog-sitenow takes--outputand--siteexplicitly and is
run by rigspark-web's daily catalog sync, not by catalog admission here.- The site checks (download links, FAQ structured data, canonical URL,
catalog counts) run in rigspark-web's CI.
Fixes
- Stopping a model server no longer gives up while it shuts down. After the
stop signal, an identity probe can fail briefly while the server exits (seen
on macOS with Ollama).rigspark upanddownused to stop with "process
identity unavailable after signal" and keep a stale record, even though the
server then exited. Now they keep waiting: up to 3 s for a clean exit (model
servers unload weights) before forcing.- Still fails closed: a process is only signalled, and only force-stopped,
after its identity matches the one RigSpark started. - If nothing listens any more and the recorded process is gone, or its PID
now belongs to another program, the server counts as already stopped.
- Still fails closed: a process is only signalled, and only force-stopped,
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedDesktop: download RigSpark_aarch64.dmg (Apple Silicon), RigSpark_x86_64.dmg (Intel Mac) or RigSpark_x64-setup.exe (Windows). The Mac app is signed with a Developer ID and notarized by Apple, so it opens like any other app.
Archives are unsigned. Verify downloads against SHA256SUMS and each .sha256 file.
rigspark v3.0.7
Features
- Signed and notarized Mac app.
RigSpark_aarch64.dmgand
RigSpark_x86_64.dmgare signed with a Developer ID, use the Hardened
Runtime and are notarized and stapled by Apple, so macOS opens them without
the "Open Anyway" step.- The bundled
llama-serveris signed with the same identity. - Tagged releases fail instead of shipping an unsigned dmg when the signing
or notarization secrets are missing; see
docs/references/macos-signing.md.
- The bundled
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedDesktop: download RigSpark_aarch64.dmg (Apple Silicon), RigSpark_x86_64.dmg (Intel Mac) or RigSpark_x64-setup.exe (Windows). The Mac app is signed with a Developer ID and notarized by Apple, so it opens like any other app.
Archives are unsigned. Verify downloads against SHA256SUMS and each .sha256 file.
rigspark v3.0.6
Features
- Windows installer. Releases include
RigSpark_x64-setup.exe, the desktop
app as a per-user NSIS installer with no admin prompt. The download section
on the site offers it to Windows visitors.- It bundles a CPU-only (AVX2)
llama-serverbuilt from the same pinned
llama.cpp commit, with a static C runtime, so the starter model runs
without installing anything else. - While that bundled build serves llama.cpp, model advice ignores discrete
GPUs, so verdicts reflect how it actually runs. - Before uploading, the release job installs it silently and checks that
the app andllama-server.exewere installed and thatllama-server.exe
runs. - In-app updates cover Windows:
latest.jsongainswindows-x86_64.
- It bundles a CPU-only (AVX2)
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedDesktop: download RigSpark_aarch64.dmg (Apple Silicon), RigSpark_x86_64.dmg (Intel Mac) or RigSpark_x64-setup.exe (Windows). The app is not notarized yet; on first launch open System Settings > Privacy & Security and click Open Anyway.
Archives are unsigned. Verify downloads against SHA256SUMS and each .sha256 file.
rigspark v3.0.5
Features
- Ready to run after install. The Mac app bundles a
llama-serverbuilt
from pinned llama.cpp v0.8.0 (Metal, no other dependencies), so a model runs
without installing Ollama or llama.cpp.- A user-installed llama.cpp still takes precedence over the bundled one.
- On first launch the chat screen offers a starter model that runs well on
this machine (Qwen3 8B, 4B or smaller), with one Download & start
click. On llama.cpp it starts at an 8K context. qwen3:4bandqwen3:8bgain pinned official Qwen GGUF sources, with
cited records indocs/references/catalog-corrections.json.
- Launch at login is on by default after the first launch, starting in the
menu bar. Turn it off in Tools.
Fixes
- The Mac app is no longer reported as damaged. Release bundles are now
sealed with an ad-hoc signature, and the release job verifies the seal with
codesign --verify --deep --strict. macOS asks once to approve the
un-notarized app (Open Anyway) instead of refusing to open it.
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedDesktop: download RigSpark_aarch64.dmg (Apple Silicon) or RigSpark_x86_64.dmg (Intel). The app is not notarized yet; on first launch open System Settings > Privacy & Security and click Open Anyway.
Archives are unsigned. Verify downloads against SHA256SUMS and each .sha256 file.
rigspark v3.0.4
Features
- Mac desktop app. Releases include
RigSpark_aarch64.dmg(Apple Silicon)
andRigSpark_x86_64.dmg(Intel). They are unsigned and not yet notarized,
so on first launch Control-click the app and choose Open.- RigSpark stays in the menu bar when its window closes, and can launch at
login. - In-app updates install only after their signature is verified against the
key built into the app. - When opened from Finder, it finds runtimes in
/opt/homebrew/binand
/usr/local/bin.
- RigSpark stays in the menu bar when its window closes, and can launch at
- Add from Hugging Face.
rigspark addand the Add from Hugging Face
button at the top right of Models search GGUF repositories and list every
single-file quantization with a fit verdict.- The chosen quantization is pinned to its commit and SHA-256 in a local
catalog (~/.rigspark/catalog/local.json) and marked added by you. - It runs on llama.cpp or Ollama with the usual fail-closed digest check.
- Only repositories with a recognized open-weight license are accepted.
- The chosen quantization is pinned to its commit and SHA-256 in a local
- Speculative decoding on llama.cpp: models with a catalog drafter use it
by default (qwen3:0.6bfor Qwen3 14B, 30B-A3B and 32B).- The drafter's SHA-256 is verified, and its memory is reserved before the
fit check. --speculative auto|draft|ngram|offoverrides the default.- Catalog schema v4 adds the optional
drafterfield; catalogs without
drafters are still published as v3.
- The drafter's SHA-256 is verified, and its memory is reserved before the
- Parallel slots.
--parallel Nruns concurrent requests: one unified KV
pool on llama.cpp, andOLLAMA_NUM_PARALLELon Ollama, with memory sized
per slot. rigspark benchmeasures the active server with fixed, versioned
prompts: time to first token, prefill and decode tok/s, draft acceptance,
and combined throughput across concurrent requests. Figures the runtime
does not report show asunknown.rigspark connect <agent>starts Claude Code, Codex or OpenCode against
the active server without editing their config files, and prints setup
steps for Pi, Hermes, OpenClaw and Cline.- GUI.
- A Coding agents panel in Tools.
- Speculative and Parallel slots settings under Fit settings.
- In the desktop app, the theme follows the macOS appearance until you
choose one.
Fixes
- New models reach users again. The weekly model-admission job had failed
since Oct 12, because a test hard-coded a date that went stale once the job
re-stamped the catalog. - Upgrading uses the newer catalog. A newer catalog bundled with an
upgrade now replaces an older downloaded one, instead of staying pinned to
the lastcatalog --update. - A gone model server no longer blocks you. After a reboot or a daemon
exit,up,switchanddownclear its stale record instead of refusing
to continue. No running process is ever signalled. Chat errors now name
the cause and the next step. - Ollama 0.40+. rigspark reads Ollama's new content-addressed manifest
store (manifests-v2) and the upstream manifest digest Ollama now reports.
A linked blob must hash to its address, and an embedded digest is trusted
only when its blob verifies. - Start catches models the runtime can't run. After switching to an
Ollama model, rigspark loads it once, so a runtime that cannot run it (for
example an unknown architecture) fails at start with Ollama's reason
instead of on the first chat. - Safer context defaults. A model whose memory at a given context can't be
sized now starts at 8K, instead of a percentage of its maximum or a runtime
default that fills free memory. llama.cpp accepts an explicit context
window. - Chat memory without an embedding model. Chat no longer drops the
conversation whennomic-embed-textis missing or unreachable: the turn
and facts are saved, and chat explains how to enable recall search. - Download progress shows the file's real size instead of the limit used
to check it. - Command-line fixes.
rigspark benchandrigspark connectno longer panic.connect --dry-runis accepted.- The Homebrew
PATHfallback applies only to the desktop app.
- Dialog. Escape closes Add from Hugging Face even after focus has left
the dialog.
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedDesktop: download RigSpark_aarch64.dmg (Apple Silicon) or RigSpark_x86_64.dmg (Intel). The app is not notarized yet; on first launch, Control-click RigSpark in Applications and choose Open.
Archives are unsigned. Verify downloads against SHA256SUMS and each .sha256 file.
rigspark v3.0.3
Generation
- Enable Ming Image 0.1 Design INT8 for UI/UX mockups in the CLI and browser GUI.
The verified pairing uses the 19.51 GB INT8 text encoder (25.94 GB total weights),
not the smaller W4A8 fit-only estimate. Other Ming variants remain fit-only.
Real generation and inline GUI preview passed on a 36 GiB Apple Silicon Mac with
ComfyUI 0.38.0. CUDA and peak inference memory remain uncertified; generated
lettering may be garbled. The default image model is unchanged. - Accept native ComfyUI single-choice COMBO capability schemas while rejecting
malformed options and unsupported multiselect inputs before downloading weights. - Retry failed download-resume requests within the existing bounded retry budget,
preserving exact range, commit, size, and final SHA-256 verification. - Website and README show a real locally generated Ming UI/UX example.
Fixes
- GUI: on narrow screens a long conversation could make the whole page
scrollable, adding blank space under the chat and stopping the reply from
following new text. The screen-reader-only "You"/"Assistant" labels now stay
inside their message.
CI
- Desktop verification runs on
mainagain (it only targeted retired migration
branches), uses the same--test-threads=2as CI, and finds ChromeDriver even
when the runner image doesn't setCHROMEWEBDRIVER. - Browser journeys retry clicks on list items that were re-rendered, and the
narrow-screen scroll checks use the chat's real scroller.
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedArchives are unsigned. Verify downloads against SHA256SUMS.
rigspark v3.0.2
Support the project
brew installnow ends with a short note: if Sparky helps you, please
consider sponsoring the project at https://buymeacoffee.com/shashanksw9.
Cargo can't print messages after an install, sorigspark --helpends with
the same note. The README, guide and site link to it too, and the repository
shows a Sponsor button.
Fixes
- GUI: the "Skills this agent loads" checkboxes in the Library agent editor no
longer stretch to half the row and squeeze each skill name onto several lines.
Tests
- The
gui_launcherprocess tests no longer time out under parallel load on
macOS.
Docs
- The guide's agents/skills and connectors recordings show the 3.0 interface.
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedArchives are unsigned. Verify downloads against SHA256SUMS.
rigspark v3.0.1
Licensing
- Release archives now include
fonts.OFL.txt, the SIL Open Font License 1.1
for the Inter and JetBrains Mono fonts thatrigspark-guihas embedded since
3.0.0.THIRD-PARTY.mdlists both fonts with their versions and upstreams. - Correct the copyright notices in the font license shipped with the GUI and
the site: they named Bricolage Grotesque instead of the fonts RigSpark
actually ships (Inter 4.001 and JetBrains Mono 2.211).
Tests
- The full-catalog ranking test no longer depends on the CI runner's live
memory. Route tests check the limit bounds, and the full-catalog properties
are checked against fixed hardware.
Install
brew install shashankswe2020-ux/tap/rigspark
cargo binstall rigspark-cli rigspark-gui
cargo install rigspark-cli --locked --bin llmup --bin rigspark && cargo install rigspark-gui --lockedArchives are unsigned. Verify downloads against SHA256SUMS.