Repository navigation
Releases
Eisoptric Workbench v0.7.0
Eisoptric Workbench is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Eisoptric Workbench's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Workbench-0.7.0-mac-arm64-unsigned.dmg, open it, and drag Workbench into Applications (the.ziphas the same app). - Open Workbench. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Workbench-0.7.0-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Eisoptric Workbench's. In PowerShell,
(Get-AuthenticodeSignature .\Workbench-0.7.0-win-x64-setup.exe).SignerCertificate.Thumbprintshould print9D9E3A5CDA1828A13D6F23C75E5D58E9E4E6ED8A.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.workbench-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Eisoptric Workbench, and it must carry a signature from Eisoptric Workbench's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Workbench-0.7.0-mac-arm64-unsigned.dmg.sha256
gh attestation verify Workbench-0.7.0-mac-arm64-unsigned.dmg -R eisoptric/WorkbenchThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Workbench-0.7.0-mac-arm64.sigstore.json -R eisoptric/Workbench checks a macOS download offline (-win-x64.sigstore.json for Windows).
Workbench-0.7.0-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
workbench-worker-0.7.0-linux-x64 and -linux-arm64 are the worker Workbench installs on a Linux SSH host when you press Install worker in Environment; you do not need to download them. Eisoptric Workbench checks each against the hash built into this release before sending it, and the host needs libssl 3 (Ubuntu 22.04, Debian 12, RHEL 9 or later).
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
Changed
- Saturn is now Workbench, by Eisoptric. The app, its window, the Dock, the installers and the
workbenchcommand (wassaturn) are named Workbench, and the repository moved to eisoptric/Workbench. Updates still come from GitHub Releases; the app identifier is nowcom.eisoptric.desktop, so macOS and Windows treat it as a new app. - Your data is in new places, and what was there before is not carried over. The data folder is
~/.workbench-app(was~/.saturn-app), a project's research is in.workbench/(was.saturn/), the variables areWORKBENCH_*(wasSATURN_*, for exampleWORKBENCH_DATA_DIR,WORKBENCH_RUN_SAMPLES), and the helper a run imports isworkbench_run.py. Saved API keys are sealed under a new label, so they have to be entered again. To keep earlier work, move.saturn/to.workbench/in each project before opening it. - A new icon: the Speculum. A capital E faces its reflection across a gilt mirror line, inside a ring, on the Nocturne night ground. It replaces the ringed planet in the Dock, the taskbar, Settings → About and the pointer the assistant draws while it uses the computer, which now glows in the icon's ivory.
- Windows installers are signed with a new certificate. The publisher reads Eisoptric (was Saturn Technology Project), and the SHA-1 thumbprint to check is
9D9E3A5CDA1828A13D6F23C75E5D58E9E4E6ED8A(wasD285DA42…C786). The certificate is still self-signed, so Windows still names an unknown publisher when it asks. - The old Saturn app stays where it is. Because the identifier changed, installing Workbench does not replace Saturn: both are installed side by side, and Saturn still opens with everything it had in
~/.saturn-app. Keep it until you have what you need from it, then delete it as you would any app. - Remote hosts need the worker installed again. Workbench keeps its worker in
~/.workbench/workeron an SSH host and reports a host that only has Saturn's as having none; Environment offers to install it. Saturn's worker in~/.saturn/workeris no longer used and can be deleted. - The app no longer names itself in what it says. Screens, messages, the tour, notifications, the assistant's instructions and the files it writes into a project say "the app" (本 App in Chinese) where they named it; only Settings → About carries the brand. Commits the app makes are authored by Workbench and titled by the chat alone, without a name in front. The Keychain entry is named Workbench.
- Headers the runtime sends and reads start with
Eisoptric-orX-Eisoptric-(wasSaturn-,X-Saturn-).
What's Changed
- Docs: what Windows was tried on, the close prompt, and the sandbox's gaps, under Known limitations by @rickwengdev in #117
- Bump the desktop-minor-and-patch group across 1 directory with 5 updates by @dependabot[bot] in #118
- Bump the rust-minor-and-patch group across 1 directory with 2 updates by @dependabot[bot] in #113
- Bump the actions group across 1 directory with 4 updates by @dependabot[bot] in #111
- Runtime: getrandom 0.4 in every crate, with the lock files to match by @rickwengdev in #119
- Rebrand to Eisoptric Workbench with the Speculum icon by @rickwengdev in #120
- Brand: Saturn becomes Workbench, and the app no longer names itself by @rickwengdev in #121
- Windows: sign with Eisoptric's certificate by @rickwengdev in #122
- Interface: the runtime is "the runtime", and the helpers kit is the app's by @rickwengdev in #123
- Release: 0.7.0 by @rickwengdev in #124
Full Changelog: v0.6.4...v0.7.0
Saturn v0.6.4
Saturn is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.6.4-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.6.4-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.6.4-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.saturn-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Saturn, and it must carry a signature from Saturn's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.6.4-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.6.4-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Saturn-0.6.4-mac-arm64.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a macOS download offline (-win-x64.sigstore.json for Windows).
Saturn-0.6.4-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
saturn-worker-0.6.4-linux-x64 and -linux-arm64 are the worker Saturn installs on a Linux SSH host when you press Install worker in Environment; you do not need to download them. Saturn checks each against the hash built into this release before sending it, and the host needs libssl 3 (Ubuntu 22.04, Debian 12, RHEL 9 or later).
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
How Windows was tried: on Windows 11 for ARM in a virtual machine, running the x64 build under emulation, signed in as an administrator. Nothing in this version or the Windows work before it has been tried on x64 hardware, or under a standard (non-administrator) account, where the sandbox's Set up asks for an administrator's password instead of a yes.
Added
- Windows: closing the window asks first while something is still working. Closing Saturn's window quits it, and quitting stops what it was doing. When a chat is still answering, an experiment run is going on this computer or a background command is running, Saturn now names them and asks before it quits; otherwise it quits at once.
Fixed
- Windows: computer use types every character into Windows 11's Notepad. Typed text came out scrambled: letters repeated or replaced, and everything after Chinese text lost, with an English keyboard or Bopomofo. Text is now pasted, as on macOS, and your clipboard is put back afterwards; what Saturn pastes is kept out of clipboard history and cloud clipboard.
- A short experiment run shows what it cost. Runs were read every two seconds, so a run of a second or two had one reading, taken as it started, with no memory yet. A run is now read after a quarter, a half and a whole second, then every two seconds as before.
- Why the sandbox is off is shown in your language. Settings → General → Sandbox gave the reason (the setup not run, the administrator prompt declined, bubblewrap missing) in English inside a Chinese sentence.
Changed
- Automations (scheduled prompts) are removed. They were only reachable from Settings → Still running, where an automation from the earlier interface could be turned off. Saturn no longer runs them on a schedule, agents no longer have the
automation_tools, and the/automationsroutes are gone (a script that called them now gets a 404). Automations you saved stay instate.jsonbut no longer run. The rest of that toolkit (widget templates, rules and skills, legacy workflows and plugins) is now called Customizations; agents that had Automations get Customizations, and tools you turned off stay off. The Background Model setting now only writes memory notes. - The README no longer points to a Saturn SDK. Its repository is no longer offered; scripts reach the same local API directly (README, Local API) or through the
saturncommand.
What's Changed
- Wrap-up: automations removed, Windows quit prompt and typing, fuzzing by @rickwengdev in #109
- Windows: shortcuts reach Windows 11's apps whole; the changelog says how Windows was tried by @rickwengdev in #114
- Research: a short run is read while it works, not only as it starts by @rickwengdev in #115
- Release: 0.6.4 by @rickwengdev in #116
Full Changelog: v0.6.3...v0.6.4
Saturn v0.6.3
Saturn is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.6.3-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.6.3-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.6.3-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.saturn-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Saturn, and it must carry a signature from Saturn's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.6.3-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.6.3-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Saturn-0.6.3-mac-arm64.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a macOS download offline (-win-x64.sigstore.json for Windows).
Saturn-0.6.3-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
saturn-worker-0.6.3-linux-x64 and -linux-arm64 are the worker Saturn installs on a Linux SSH host when you press Install worker in Environment; you do not need to download them. Saturn checks each against the hash built into this release before sending it, and the host needs libssl 3 (Ubuntu 22.04, Debian 12, RHEL 9 or later).
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
Added
- Windows: a sandbox for commands and experiment runs, once it is set up. Windows had no sandbox; a command ran as you. It can now run in an AppContainer, which reads and writes only what Saturn opens to it: the project folder, a temporary folder, the package caches and the folders on
PATH. A run reads its snapshot and writes its own records and output, as on macOS and Linux, and with the network off nothing leaves the computer. It is off until a one-time setup has run as an administrator: Settings → General → Sandbox says so and has a Set up button, andsaturn-server.exe --appcontainer-setupdoes the same from a terminal (the README says what it opens and why). Until then commands run as before and say so. Two differences from the other systems remain. A sandboxed command cannot reach a server on the same computer outside the sandbox (localhost, a local model server included), even with the network on. And Saturn adds entries to the access lists of the folders it opens, which stay. - Windows: experiments run. Starting a run on Windows answered "not supported yet". A version's command now runs there through
cmd, from its own checked snapshot, with its evidence, resuming and stopping as on macOS and Linux. One difference: a run cannot be paused. - Windows: the environment check, notebooks, looking inside a model and language servers work. Each of these refused on Windows. The project's Python is found the Windows way (
python.exe,.venv\Scripts), and a language server as an.exeor the.cmdnpm writes. Reading Parquet and dataset folders through the project's Python is no longer refused either, but has not been tried on Windows with a real Python yet.
Fixed
- Windows: the Terminal panel reports the right folder and exit code. After a command it showed the folder from before the command ran, so
cdseemed to do nothing, and every command read as having succeeded. - Windows: Claude Code and Codex are given the project folder in its plain form. They were handed its
\\?\long-path spelling. - Windows: removing a program Saturn downloaded no longer fails with "Access is denied". Windows holds a program's file for a moment after it ends; Saturn now tries again.
- The message for a missing ffmpeg no longer tells Windows and Linux users to use Homebrew.
What's Changed
- Windows: experiments, notebooks, model inspection and language servers run, with a sandbox by @rickwengdev in #107
- Release: 0.6.3 by @rickwengdev in #108
Full Changelog: v0.6.2...v0.6.3
Saturn v0.6.2
Saturn is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.6.2-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.6.2-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.6.2-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.saturn-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Saturn, and it must carry a signature from Saturn's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.6.2-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.6.2-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Saturn-0.6.2-mac-arm64.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a macOS download offline (-win-x64.sigstore.json for Windows).
Saturn-0.6.2-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
saturn-worker-0.6.2-linux-x64 and -linux-arm64 are the worker Saturn installs on a Linux SSH host when you press Install worker in Environment; you do not need to download them. Saturn checks each against the hash built into this release before sending it, and the host needs libssl 3 (Ubuntu 22.04, Debian 12, RHEL 9 or later).
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
Fixed
- Windows: Saturn starts on a computer without the Visual C++ runtime. The runtime and the
saturncommand neededVCRUNTIME140.dll, which Windows does not come with, so on a new Windows the app showed "Runtime off" and a system error for each attempt to start it. Both now carry the C runtime inside them, as the app's own program already did. Until you have this version, installing Microsoft's Visual C++ Redistributable (x64) makes 0.6.1 and earlier start. - Windows: the first project is no longer Saturn's own installation folder. On Windows the app starts its runtime in the folder it is installed in, and the runtime made that folder the first project, named Saturn; allowing access to it would have let agents write beside Saturn's programs. The first project is now the Workspace folder in Saturn's data, as on macOS, and a first project an earlier version left on the installation folder moves there when Saturn starts. If you allowed access to that project, look at what is in the installation folder (
%LOCALAPPDATA%\Saturn). - Windows: no second set of window buttons in the corner of the screen. The see-through window Saturn draws the assistant's pointer in also drew Minimize, Maximize and Close at the top right of the screen. They did nothing, covered the main window's own Maximize and Close when it reached that corner, and stayed after the window was closed.
- Windows: closing the window quits Saturn. Close left Saturn and its runtime running with no window, no icon to bring it back and no way to quit but Task Manager. Closing the window now quits, which is also when a downloaded update installs; minimize the window to keep work running. On macOS, as before, the app stays in the Dock.
- The window opens inside a small display. Saturn's usual window is 840 points tall, more than a 13-inch display at 200% leaves above the taskbar, so it opened over the taskbar with its lower edge off the screen. On a display with less room the window now takes what fits.
- Windows: shortcuts are shown with Ctrl. The title bar, the command list, Settings and the tour showed the Mac's sign ("Commands ⌘K") for keys that are pressed with Ctrl on Windows; they now read "Ctrl+K". The access dialog no longer says what macOS may ask.
- Dark theme: the row under the pointer shows in dialogs and menus. The dark theme's highlight was the same solid color as a dialog or a menu, so in Settings' list, for one, the row under the pointer looked like the others and the chosen row lost its mark while the pointer was on it. The highlight is now a light veil that shows on any surface, as the light theme's already was.
- A background command that has ended has all of its output. A command an agent started in the background could be reported as ended a moment before its last lines were read, so the agent, reading it then, saw the output cut short. Its end is now recorded once its output has been read.
- A long file path no longer runs out of the assistant's step list. While the assistant worked, the line naming what it was doing was not cut to fit, so a long command or path ran past its box, and on Windows a file's whole path (
C:\…) was shown where macOS shows its last two parts. A step now names a file by the end of its path on both, and the line is cut to fit.
Changed
- Saturn no longer carries a list of each provider's models. The lists built into Saturn went out of date with every model release. For Claude, OpenAI, Gemini and DeepSeek, Settings → Models now shows what the provider lists for your key: the saved one, or the one you are typing in the form, before anything is saved. A model connected from that list keeps the name and the context window its provider gives it, where Saturn used to assume 200,000 tokens for every Claude model. Without a key the model ID is typed in. Claude Code and Codex offer names that follow their newest models (
opus,sonnet,haiku,fable, or the program's own default) instead of versions; models you already connected keep working as they are. A model connected by its ID alone is now named by that ID. - What a Claude model accepts is asked of Anthropic, not read from its name. Saturn decided whether to send adaptive thinking, an effort and a temperature by patterns in the model's ID, which had to be kept up with each new family. It now uses what Anthropic's list says of the model, saved on the connection when the model is connected from the list; a model connected earlier or by its ID is asked about once, the first time it is used, with one request to the address its requests already go to. A model Anthropic says nothing of, behind a proxy for one, is asked as a current model, and a setting it refuses is dropped and the request sent again, as before.
What's Changed
- Windows: Saturn starts on a clean Windows, and what its first real run found by @rickwengdev in #102
- Desktop: the dark theme's highlight shows on dialogs and menus by @rickwengdev in #103
- Models: a provider's models come from its own list, and Saturn names no version by @rickwengdev in #104
- Release: 0.6.2 by @rickwengdev in #105
- A background command ends with all its output, and a long path stays inside the step list by @rickwengdev in #106
Full Changelog: v0.6.1...v0.6.2
Saturn v0.6.1
Saturn is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.6.1-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.6.1-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.6.1-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.saturn-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Saturn, and it must carry a signature from Saturn's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.6.1-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.6.1-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Saturn-0.6.1-mac-arm64.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a macOS download offline (-win-x64.sigstore.json for Windows).
Saturn-0.6.1-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
saturn-worker-0.6.1-linux-x64 and -linux-arm64 are the worker Saturn installs on a Linux SSH host when you press Install worker in Environment; you do not need to download them. Saturn checks each against the hash built into this release before sending it, and the host needs libssl 3 (Ubuntu 22.04, Debian 12, RHEL 9 or later).
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
Security
- A command an agent runs can no longer read Saturn's token or keys. The sandbox around shell commands limited only where they could write, so a command that matched no risky pattern, run without a card in the default mode, could read the runtime's token and both halves of the key store, send them anywhere, and use the token to turn its own sandbox off. Commands now can neither read nor write Saturn's data folder or the usual credential folders (
~/.ssh,~/.aws,~/.config/gh,.npmrcand the like). If a command of yours needs one of these, run it with the sandbox off, which asks first. - A project's instruction files and skills reach agents only once you allow them.
AGENTS.md,CLAUDE.md,.saturn/rules,.agents/rules,.cursorrulesand the project's skills went into every agent's prompt as instructions to follow, though a cloned repository brings them. They are now held until you read and allow that exact content: the research assistant shows a line with Review, and Settings → Projects has them too. Any change, an agent's own new rule included, asks again. The rules you save in Saturn always apply, and a project's skill can no longer replace one of Saturn's research skills by taking its name. - The project's Python, its environment jobs and its check command run in the sandbox. Saturn ran the project's interpreter (for the environment check, notebooks, looking inside a model, reading data and the language server), environment installs and the project's check command with your whole environment and no sandbox, so a cloned project's environment could run code with full access as soon as a Python file was opened. They now run in the project's command sandbox, the check command with PATH alone, and its output goes back to the agent marked as output. The assistant changing the project's interpreter asks first.
- The desktop app no longer hands its token to whatever listens on the runtime's port. While it waited for the runtime it sent the long-lived token with every health check, so a program of another user holding port 4700 could take it. The health check carries no token, each time the app opens the runtime gets a new one, the interface sends it only once the app has seen its own runtime answer, and no program Saturn starts inherits it.
- Fewer ways for an injected agent to act or persist without you. A file patch is judged by the files it touches, so a rule like
files: write secrets/**or a.claude/settings.jsonEdit(...)deny now stops it, and deleting a file asks; a rule allowing a shell or launcher with a wildcard (sh *,env *) is refused like*; commands that reach for Saturn's keys or a key store ask; a task delegated to another agent asks at least as much as the chat it came from; creating, enabling or running an automation asks; in Ask and Plan chats the web tool and the browser open only plain addresses, not one whose query or path could carry what the chat read; memory notes come only from what you typed; a model's source can no longer open Saturn's data to an experiment run. - Fewer places a secret can show. Claude Code no longer inherits other services' credentials from your environment (it keeps Anthropic's, and AWS and Google ones for Bedrock and Vertex); the network log leaves out a path segment long enough to be a token, as it already did the query string.
Fixed
- Signing in to an MCP server in the browser works. Connecting a remote server that needs a sign-in now opens its sign-in page, and the browser's return to Saturn finishes it; before, the return address did not exist, and such a server could only fail with "requires sign-in". The return finishes only a sign-in Saturn started, once. A server waiting for its sign-in has a Connect button.
- Windows: opening an address in the browser no longer goes through cmd, which would have read an
&in it as a second command. - The access dialog keeps its buttons inside it. A long folder path widened the dialog's content past its edge, so the note under it and Cancel and Allow Access sat over the window behind. The whole path now wraps inside the dialog, in that dialog and in Edit Workspace.
Changed
- The project list says where each project is, and adding one stands apart. The list at the top of the window shows each project's folder under its name, with the home folder written
~, and a line sets "Add a project folder…" off from the projects. The name is given the room it needs, up to a limit, instead of a fixed width that cut a long one short. - Group chats, prompt commands and the editor's completion routes are gone from the runtime. No screen has opened a group chat since 0.4.0, run a plugin's
/command or asked for an inline completion, so the routes behind them (/groups,/commands,/complete) and their code are removed; a script that called them now gets a 404. A plugin still installs with its skills, hooks and MCP servers, and Settings → Plugins no longer counts its commands. Groups and their messages from an earlier version stay instate.json. A group's turn that such a version left waiting for an approval or asleep is ended when Saturn starts, with the reason, instead of going on under the agent's own approval setting. Usage already recorded for completions still shows in the usage summary.
Added
- A computer without Python gets one from Saturn. When neither uv nor Python is found, Environment offers to download uv (about 15 MB, from its GitHub release, checked against a checksum pinned in Saturn, like the Claude Code and Codex downloads), and making the managed environment then has uv install a Python first, the version you chose or the newest stable, before the environment is made from it. A computer with Python but no uv is offered the same download, since uv is what lets a Python version be picked. Saturn's copy of uv can be removed like the other programs; the Python uv installed stays in uv's own folder.
What's Changed
- Programs: uv is downloaded, and a computer without Python gets one from it by @rickwengdev in #90
- Shell: the access dialog keeps its buttons, and the project list shows where each project is by @rickwengdev in #91
- Bump taiki-e/install-action from 2.88.1 to 2.89.1 in the actions group by @dependabot[bot] in #92
- Bump the desktop-minor-and-patch group in /desktop with 2 updates by @dependabot[bot] in #93
- Bump base64 from 0.22.1 to 0.23.1 by @dependabot[bot] in #94
- Bump macos-accessibility-client from 0.0.1 to 0.0.2 by @dependabot[bot] in #95
- Runtime: the unused sha1 dependency goes by @rickwengdev in https://github.com/Saturn-Technology-...
Saturn v0.6.0
Saturn is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.6.0-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.6.0-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.6.0-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.saturn-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Saturn, and it must carry a signature from Saturn's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.6.0-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.6.0-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Saturn-0.6.0-mac-arm64.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a macOS download offline (-win-x64.sigstore.json for Windows).
Saturn-0.6.0-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
saturn-worker-0.6.0-linux-x64 and -linux-arm64 are the worker Saturn installs on a Linux SSH host when you press Install worker in Environment; you do not need to download them. Saturn checks each against the hash built into this release before sending it, and the host needs libssl 3 (Ubuntu 22.04, Debian 12, RHEL 9 or later).
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
Security
- Permission rules now govern Claude Code and Codex turns. The rules under Settings → Permissions and in a project's
.saturn/settings.jsonor.claude/settings.jsonwere consulted only by Saturn's own agent loop; a Claude Code turn asked by its own approval setting alone, and a Codex turn asked only in Review mode. A deny now refuses the call and tells the program why, an allow runs it without a card in any mode, and an ask asks even in Bypass, naming the rule on the card. Claude Code'sBashis judged as thecodetool and its file tools asfiles, by action and path; a Saturn skill is judged by its own name. Codex runs its own shell commands and edits without asking Saturn, so a rule cannot reach those.
Fixed
- Windows: Saturn no longer opens a terminal window beside the app. The app started its runtime as a console program, so Windows gave the runtime a console window of its own, which showed its log for as long as Saturn ran. The runtime is now started without one, and every program the runtime starts in turn (git, Python, ssh, MCP servers, the desktop helper, nvidia-smi and the rest) is started without a window too, since a program started by a process without a console would otherwise get a visible one. The runtime's log still reaches the app, which shows its last lines when the runtime fails to start. Windows has only been type-checked for this change, not run.
- Windows: uv and Python on PATH are found, and the managed environment can be made. Environment looked for programs named
uvandpython3as Unix spells them, so on Windows it found neitheruv.exenorpython.exeand offered no way to make the environment; and its jobs ran through/bin/sh, which Windows does not have. Programs are now looked for as Windows spells them (the Store's emptypython.exealias does not count), the environment is made with the Python that was found, and the jobs run through cmd with its own quoting. Type-checked for Windows, not run there. - The training template's checkpoints now carry the GPU's random state, and a resume reports only what it put back.
train_loop.pysaved torch's CPU generator alone, so a run resumed on CUDA would have drawn its dropout and sampling noise from a fresh generator while its report saidrngwas restored; in fact a resume on a GPU stopped before that with "RNG state must be a torch.ByteTensor", because loading the checkpoint onto the device moved the generator's state there too. The checkpoint now holds each generator by name, Python's, NumPy's, the CPU's and every CUDA device's, and the resume report names each one restored (rng:cpu,rng:cuda) and lists undernotRestoredany the checkpoint held but this machine could not take, such as CUDA state from another number of devices. The skills on resuming say the same, and that a resumed GPU run agrees with an uninterrupted one only to within its kernels' nondeterminism. A program copied from the earlier template keeps its old behavior until the two functions are copied again. - A remote job's output comes back as fast as SSH carries it, and a long training log no longer stops it. Each exchange with the worker carried at most 128 KiB per output and the next waited a second, so a busy log fell minutes behind, and any output past 64 MiB stopped synchronization. Parts are now up to 1 MiB and follow one another while more is waiting, and logs, metrics and resource readings may reach 1 GiB each. Install the worker again on each SSH host after upgrading.
- The research assistant is made only once. When two screens asked for the assistant at the same moment on a first start, each could make one, and chats were split between them. They now share the one being made.
- The Workspace terminal keeps what a command set for the next one. Each command runs in a new shell, so
source .venv/bin/activate,exportor a shell function used to be gone by the next command, and Python ran outside the virtual environment. Each terminal panel now carries its environment, functions and shell variables from one command to the next, so an activated environment stays active anddeactivaterestores the oldPATH. (An alias carries over only in bash; zsh does not apply aliases inside a script.) A new project's terminal starts fresh. The environment stays inside Saturn's runtime and is never sent to the app. Not on Windows yet.
Changed
- Lists of choices show which option the pointer is on. In the dark theme the highlighted option of a drop-down list (the assistant's Ask, Approve, Auto and Agent modes, a permission rule's allow, ask and deny) had no background of its own, since the highlight color was the list's own color, so only its explanation turning white marked it. The highlighted option is now tinted in both themes and its explanation stays muted, a list whose options carry explanations is wide enough for each to sit on one line, and the check beside the chosen option sits at the option's middle rather than on its first line.
- The Environment screen's managed-environment card lines up. Its first line (the
.venv, whether it is in use, Use and Sync from lock file) was indented further than the Other packages field under it and carried a stray divider, and the card sat flush against the job-timeout field. The line now aligns with the field, "in use" is a badge rather than part of the sentence, the card stands off from the field, the timeout says what it applies to, and a project without a lock file is told so beside the Sync button instead of only in its tooltip. The job card under it is laid out the same way, with its log in its own box. - A remote run is followed over one SSH connection instead of one a second. Saturn used to open a new SSH connection every second to ask the worker for new output. It now keeps one connection open while the run goes on, and the worker sends what the run writes as it is written, so samples and logs appear within a fraction of a second and the host sees one connection per run rather than thousands. A stop goes down the same connection. If the connection drops, Saturn says so, catches up a second later from what it already has, and opens it again; the computation on the host is never affected. The worker on the host must be this version of Saturn, as before.
- LM Studio is now Local server, and MLX is part of it. The provider under Settings → Models takes any model server on this computer with OpenAI-compatible endpoints: LM Studio, Ollama, vLLM, llama.cpp or
mlx_lm.server, at the address you give. Saturn lists the models the server has loaded, leaving out embedding and reranking models, and sends no key. The separate MLX provider is gone, since it did nothing LM Studio's path did not; a model saved under it is a Local server model now, at the same address. - The semantic code index and its embedding models are gone. No screen had reached the index since the research interface, and the assistant's tools never used it; the project's ...
Saturn v0.5.1
Saturn is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.5.1-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.5.1-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.5.1-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.saturn-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Saturn, and it must carry a signature from Saturn's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.5.1-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.5.1-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Saturn-0.5.1-mac-arm64.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a macOS download offline (-win-x64.sigstore.json for Windows).
Saturn-0.5.1-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
saturn-worker-0.5.1-linux-x64 and -linux-arm64 are the worker Saturn installs on a Linux SSH host when you press Install worker in Environment; you do not need to download them. Saturn checks each against the hash built into this release before sending it, and the host needs libssl 3 (Ubuntu 22.04, Debian 12, RHEL 9 or later).
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
Fixed
- Workspace files can be created and renamed from the file tree. New files open immediately, including empty notebooks. Renaming keeps open tabs and unsaved edits, checks an open file's revision, and refuses to overwrite an existing name. F2 renames a focused file.
- The terminal prompt follows its output. Commands appear immediately and output accumulates from top to bottom, with the next prompt underneath, rather than in a footer at the panel's bottom. Up/Down recalls commands and restores an unfinished line; Ctrl+L or
clearclears the scrollback. - A training run that lists its checkpoints can register its analysis outputs again. The checkpoint entries a program writes to its artifacts manifest, for resuming, made "artifacts from run" refuse the whole manifest. They are now passed over, and the figures and JSON beside them are registered.
- Samples changed after a run was sealed are flagged wherever the run is listed. The warning on the Experiments page never showed, because the list of runs did not check the seal; only the run's own Evidence did. The list, the Workspace's run tab and the Samples page now say so too.
- The skills no longer tell a program to write where the sandbox refuses. The checkpoint, pretraining and task skills said to save into the project folder, which a sandboxed run cannot write; they now say
SATURN_RUN_OUTPUT, and a project folder only when the person has turned the sandbox off. The starter program writes its files toSATURN_RUN_OUTPUTas its own rules say, and the list of run variables is complete. - The documents match the runtime on remote runs: the worker is started without nohup, the host checks every file of the version before running (the old "not certified identical" wording is gone from the docs and from the worker's note), the worker is installed from Environment rather than by hand, a run on the host gets only
SATURN_RESUME_FROM, and a project's skill can also live in.agents/skillsor.claude/skills.
Changed
- The source editor's Tab completes, advances snippet fields or indents, with Shift+Tab to go back or outdent, local document-word suggestions alongside language completions, and entry-point/test snippets for Python. Python, JS/TS and JSX, Rust, JSON, Markdown, Shell, YAML, TOML, TeX and Lean have syntax support; JSON also reports syntax errors. Existing indentation and CRLF endings are preserved. Recent source tabs keep undo, cursor and scroll while the Workspace is open, and a status bar shows position, indentation, line endings and editing shortcuts. Project-wide type checking and definition navigation still need a language server.
- The assistant's answers are drawn as Markdown. Headings, lists, quotes, tables, links, bold and inline code show as such instead of as raw marks; fenced code stays a copyable snippet. A link opens in your browser.
- A run's evidence shows more of what it records. Expected: the version's inputs by role, its models with whether each revision pins the weights (a commit or hash) or is a name such as
mainthat can move, and what it resumes from. Observed: the platform or host and its working folder, start, end, duration and exit code, the host's commit, where the sandbox let the program write and how many folders it hid, what a resumed run took over, and whether the snapshot was checked after the run. Reported: the settings and the restore the program described, in words rather than raw JSON, and how many report lines it wrote. The sealed samples' hash, size and count are at the bottom. - An experiment's seeds can be set in Experiments, beside the sandbox, as a comma separated list; they are passed as
SATURN_RUN_SEEDandSATURN_RUN_SEEDSand frozen into each version. A paused run says since when.
Added
- New models appear without waiting for a Saturn update. Once a provider's API key is saved, Settings lists the models that provider offers that key (Claude, OpenAI, Gemini and DeepSeek), Saturn's names first, and leaves out the ones the key cannot use. Without a key, and for Claude Code and Codex, Saturn's built-in list is shown, and "Other model ID…" takes any model ID by hand. The key is sent only to the provider's own address or one a connected model of it already uses. Prices are still Saturn's own, so a model newer than Saturn is shown unpriced on the Usage page.
- Claude Mythos 5.1 can be chosen for the Claude and Claude Code providers, beside Claude Fable 5.1. It is the same model, offered by Anthropic to verified organizations, and is priced the same on the Usage page.
- Local language servers in the source editor. Python uses Basedpyright or Pyright with the project's selected interpreter; Environment has a Python language server kit. JS/TS use TypeScript 7's native LSP (project first, then PATH), with the TypeScript 6 language-server wrapper supported; Rust uses rust-analyzer. Connected files have semantic completion, type hover, signatures, versioned push/pull diagnostics and F12 definitions within the project. Unsaved imports survive tab switches and connection restarts. The status bar reports connection state and problems, with restart/setup controls. The runtime owns and reaps server process groups, checks document paths and rejects executable commands and workspace edits. Notebook cells and Windows are not covered yet.
- Programs to start from, and an SDK.
research_templatehands the assistantsaturn_run.py, a dependency-free file an experiment imports to write samples, metrics, its report, checkpoints and artifacts the way Saturn reads them (whole lines, flushed, no duplicate sample, seeds applied and reported, SIGTERM handled), and eight runnable templates to copy into the project and change: a benchmark harness wrapper, a red-team harness, an agent trajectory recorder, a Lean proof checker, a linear-probe trainer, a steering-vector sweep, a resumable training loop, and a paper compile script. A copy is the project's own program, frozen with each version. The SDK is tested against the real Python. - The assistant reads less per turn. The research tools' descriptions are a sixth shorter, with the detail in the
saturn-research-toolsskill; a log gives its last 8 KiB and an output file 32 KiB unless more is asked for; a run's evidence gives the snapshot's file count instead of listing thousands of files unless asked; andstatuscuts a finding's text at 240 characters. - The research tools cover what the skills teach. A
documentartifact keeps a PDF, a model card, a paper or a compile log with its hash, previewed in Experiments (a Markdown card drawn, a PDF shown).research_read what: "output"lists and reads what a run's program wrote toSATURN_RUN_OUTPUT, such as an agent's trajectories or a proof checker's messages, without running anything. A label can carry arater, andwhat: "agreement"(and the Samples page) gives Cohen's and Fleiss' kappa between raters, against the adjudicated labels and against...
Saturn v0.5.0
Saturn is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.5.0-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.5.0-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.5.0-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.saturn-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Saturn, and it must carry a signature from Saturn's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.5.0-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.5.0-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Saturn-0.5.0-mac-arm64.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a macOS download offline (-win-x64.sigstore.json for Windows).
Saturn-0.5.0-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
saturn-worker-0.5.0-linux-x64 and -linux-arm64 are the worker Saturn installs on a Linux SSH host when you press Install worker in Environment; you do not need to download them. Saturn checks each against the hash built into this release before sending it, and the host needs libssl 3 (Ubuntu 22.04, Debian 12, RHEL 9 or later).
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
Fixed
- The assistant's browser can be watched again, in the Workspace. Since the research interface, an agent browsing in Saturn's own browser (the default) did so out of sight: the Browser tab its settings spoke of was gone. The Workspace now opens a Browser tab beside your files when the assistant opens a page, showing the page live with the cursor the assistant points, clicks and types with, now a black pointer with Saturn beside it so it is plain whose it is; the page fits or shows at its actual size. While you are elsewhere, the assistant panel says it is browsing and leads there.
Changed
- Running an experiment says what it does. The Workspace's bare command box and Run button are now an experiment bar beside the results' tabs, leaving the editor its room: it names the experiment (or starts a new one), takes the command after a
$, and Freeze and run says that it keeps the code as a version before running it. While the run goes, the bar shows its status and version, with Pause and Stop beside them. Open in Experiments and, on the Experiments page, Edit in Workspace move between the two on the same experiment, and Experiments can now run its newest version as it was frozen. - The workspace's samples and questions are easier to read. Each sample id now fits on one line, and a long one keeps its end in view (the full id shows on hover). A sample's scores form a small table instead of raw JSON, with zeros dimmed so what the scorer found stands out. The sidebar's questions sit apart, each behind a thin rule and up to three lines, with how many there are and a link to all of them. The sample list and the sample beside it scroll on their own, and the arrow keys move through the list.
- A worker of another Saturn version is refused. Every request now carries Saturn's version, and a check compares it, so a host can no longer run jobs with a worker that does not match the app. After upgrading, use Install worker in Environment once for each SSH host whose worker came with an earlier version.
- Samples name the model a line is about. A line that names no model used to show "Unnamed model". It now shows the version's model when the version has only one, the model's id when that id is not recorded under Models, and otherwise "Model not recorded", with a note on how to fix it. The runs table names models the same way.
- "Scorer: no word" is gone from every sample line. The scorer's word is shown only when the program wrote one; the scores are beside it either way.
Added
- Tabs in the Workspace. Every file you open gets a tab above the editor; switching keeps a tab's unsaved text, marked with a dot, and closing one with changes asks first. The tabs reopen with the project.
- Local models through MLX. On a Mac with Apple silicon, choose MLX in Settings → Models to use a model served by
mlx_lm.server(pip install mlx-lm), with no LM Studio in between. Saturn lists the models the server can load; like an LM Studio model, it needs no key and costs nothing, and it must support tool calling to act as the research assistant. - Saturn installs its own worker on an SSH host. In Environment, Connect finds this version's worker on the host and uses it; when it is missing or another version, Install worker puts the right one in
~/.saturn/worker/<version>in your home folder, with no administrator rights. It is this computer's own program when the host is the same kind of system, and otherwise the release's Linux worker (x86-64 or ARM), used only if it matches the hash built into this Saturn, and hashed again on the host. Releases now carry these workers. The assistant can see whether the worker is ready; installing stays yours. - A run can be paused and continued. A running experiment can be held where it is and let go on later, from its row in Experiments or by the assistant. It keeps its memory, and the GPU's, while paused, and the run says how long it spent paused. A paused run can still be stopped.
- A run that stopped, was interrupted or failed can be resumed. Resuming starts a new run of the same version that takes over where the old one was: an evaluation keeps the samples it finished, and its program skips them; a training run's program restores the last checkpoint the run listed, and its curve goes on from that step. The new run, and its evidence, say which run it resumed and what came along. The assistant can pause, continue and resume runs too, and a new skill tells it how, and how to write a program that can be resumed.
- An experiment can be renamed. The experiment page now shows the experiment's name above its question and hypothesis, and changing it there renames it; its versions and runs stay with it. A blank name is not saved, and a change made meanwhile elsewhere, by the assistant for one, is reported rather than overwritten.
- Training metrics follow a run while it goes. The experiment page showed a training run's curve only once the run had finished. It now shows the run still going, adds each metric as the program writes it, and reads the last ones when the run ends; before the first metric it says it is waiting. A long run's curve stays quick to draw.
What's Changed
- Docs: release tags are made by the release workflow by @rickwengdev in #65
- Experiments: training metrics follow a run while it goes by @rickwengdev in #66
- Experiments: an experiment can be renamed from its page by @rickwengdev in #67
- Samples: name the model a line is about, and drop the empty scorer word by @rickwengdev in #69
- Runs can be paused, continued and resumed, by the person and the assistant by @rickwengdev in #68
- Remote runs: pair with the SSH host's worker, and install the matching one when asked by @rickwengdev in #70
- Research assistant: test that every backend has the new run and remote tools by @rickwengdev in #73
- MLX: local models through mlx_lm.server by @rickwengdev in #71
- Workspace: readable sample ids, scores and questions by @rickwengdev in #72
- Workspace: an experiment bar, and Experiments can run its newest version by @rickwengdev in #74
- Workspace: tabs for files, and the assistant's browser live in one by @rickwengdev in #75
- Security: list the open advisories for OSV and Scorecard by @rickwengdev in https://github.com/Saturn-Technology-Project/Saturn-App/pul...
Saturn v0.4.1
Saturn is a workbench for AI research on your own computer: the app, its research assistant and its local runtime in one download.
The first release since 0.3.1. 0.4.0 was tagged but never published, so 0.4.1 also brings everything in 0.4.0: the rewrite in Rust and Tauri, the experiment sandbox, run evidence and the rest. The "What changed" section below lists only what 0.4.1 adds to it.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.4.1-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.4.1-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.4.1-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models and connect a model, add a project folder, and write your first question (the first launch walks you through it). The interface is in English or Traditional Chinese, following the system or chosen in Settings → General.
Updating: from a version before the rewrite in Rust and Tauri (0.3.1 or earlier), install this one by hand; your data in ~/.saturn-app keeps working. Later versions update themselves: the update downloads in the background and installs when you quit Saturn, and it must carry a signature from Saturn's updater key.
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.4.1-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.4.1-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle Saturn-0.4.1-mac-arm64.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a macOS download offline (-win-x64.sigstore.json for Windows).
Saturn-0.4.1-sbom.cdx.json lists the crates, npm packages and model this release is built from (CycloneDX 1.5, with their hashes), for your scanner or your security team.
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
What changed
Changed
- Newer versions of the libraries that encrypt saved keys, hash records, read the local search model and talk to the agent browser. aes-gcm 0.11 encrypts and decrypts exactly as before, so keys saved by earlier versions still open; sha2 0.11 gives the same hashes, so research records and their evidence still check out; tokenizers 0.23 reads the built-in search model the same way, so local search finds what it found before; and tokio-tungstenite 0.30 carries the agent browser's connection to Chrome.
- The file dialog and the single-window check on the desktop use the latest Tauri plugins (dialog 2.8.4, single-instance 2.5.5).
What's Changed
- Saturn 0.4.1: the seven dependency updates, and one command to set the version by @rickwengdev in #64
Full Changelog: v0.4.0...v0.4.1
Saturn v0.3.1
What's new in 0.3.1
Upgrade if you use 0.3.0 or earlier. This release has a security fix and a crash fix.
- Security: a project's settings files can no longer pre-approve tool calls. The allow rules in a repository's
.saturn/settings.jsonor.claude/settings.jsonapplied without being shown to you, so a cloned repository could let an agent run commands without an approval card. Their deny and ask rules still apply at once; their allow rules now wait until you approve that exact set in Settings → Permissions, and a rule allowing every command is never applied. After upgrading, check the project rules of any repository you opened. - Fixed: Saturn quitting seconds after launch while indexing a project. The built-in embedding model asked for a single 2 GiB block of memory on large files, which Electron answers by ending the app. It now works in smaller batches and uses a fraction of the memory.
- Fixed: an approval card for a Claude Code or Codex agent could refuse an answer given the moment it appeared.
- The TypeScript SDK moved to its own repository, Saturn-SDK.
Full list in the changelog.
Saturn runs AI agents on your own computer: the agent app, its local runtime and Saturn IDE in one download.
Preview build. The macOS app is not signed with an Apple Developer ID (Apple Silicon only), and the Windows installer is signed with Saturn's self-signed certificate, which Windows does not trust, so both systems warn the first time you open them.
Install
macOS (Apple Silicon)
- Download
Saturn-0.3.1-mac-arm64-unsigned.dmg, open it, and drag Saturn into Applications (the.ziphas the same app). - Open Saturn. When macOS says it can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.
Windows (x64)
- Download
Saturn-0.3.1-win-x64-setup.exeand run it. - If SmartScreen stops it, click More info → Run anyway. Later versions update themselves.
- Optional: confirm the installer is Saturn's. In PowerShell,
(Get-AuthenticodeSignature .\Saturn-0.3.1-win-x64-setup.exe).SignerCertificate.Thumbprintshould printD285DA425077C16A3D115D61F9748AFA574BC786.
Then open Settings → Models, connect a model, create an agent, and give it a task (the first launch walks you through it).
Check a download (optional): each file has a .sha256 beside it, and a signed build attestation that proves it was built from this repository's source by its public release workflow:
shasum -a 256 -c Saturn-0.3.1-mac-arm64-unsigned.dmg.sha256
gh attestation verify Saturn-0.3.1-mac-arm64-unsigned.dmg -R Saturn-Technology-Project/Saturn-AppThe signed attestations are attached too (*.sigstore.json); with one, gh attestation verify <file> --bundle <file>.sigstore.json -R Saturn-Technology-Project/Saturn-App checks a download offline.
Saturn-0.3.1-sbom.cdx.json lists every package, model and runtime this release ships (CycloneDX 1.5, with each package's SHA-512), for your scanner or your security team.
Changes
What changed in each version, and whether it affects you, is in CHANGELOG.md.
Full Changelog: v0.3.0...v0.3.1