Install splime

Start a private Python worker from a clean machine.

Download the local daemon installer for your operating system, register it as a user-owned background service, then use the Framework notebook to prove the first local SPL run before pairing the worker in the console.

Download installer Download wheels Download notebook Open console

Downloads

Pick the installer for the machine that will run Python.

Each installer creates a private virtual environment, installs `spl-framework` and `spl-daemon` from the SPL wheel bundle, configures the certifi CA bundle for HTTPS, registers the daemon service, and exposes the `spl-daemon` command in the user PATH.

macOS

install-macos.sh

LaunchAgent service, private venv, certifi bundle, and `~/.local/bin/spl-daemon` shim.

Download macOS

Linux

install-linux.sh

systemd user service, private venv, certifi bundle, and `~/.local/bin/spl-daemon` shim.

Download Linux

Windows

install-windows.ps1

Scheduled Task service, private venv, certifi bundle, and a user PATH command shim.

Download Windows

SPL wheel bundle splime-wheels-0.1.0.zip

Contains the pure `spl-framework` and `spl-daemon` wheels used by public installers. Platform-specific dependencies are resolved by pip for the target OS.

Download wheels

First install

Cold start commands for a brand-new worker.

Run the OS command on the worker machine, verify local health, then open Console and pair the daemon with issued user and machine credentials.

macOS

curl -fsSL https://splime.io/downloads/install-macos.sh -o install-macos.sh
chmod +x install-macos.sh
./install-macos.sh --install-service --start
export PATH="$HOME/.local/bin:$PATH"
spl-daemon health

Linux

curl -fsSL https://splime.io/downloads/install-linux.sh -o install-linux.sh
chmod +x install-linux.sh
./install-linux.sh --install-service --start
export PATH="$HOME/.local/bin:$PATH"
spl-daemon health

Windows PowerShell

Invoke-WebRequest https://splime.io/downloads/install-windows.ps1 -OutFile .\install-windows.ps1
Set-ExecutionPolicy -Scope Process Bypass -Force
.\install-windows.ps1 -InstallService -Start
$env:Path = "$env:LOCALAPPDATA\SPLime\local-daemon\bin;$env:Path"
spl-daemon health

Framework

Run the smallest Framework smoke demo before remote execution.

The notebook demonstrates local Framework primitives without requiring a paired daemon. After that, use the same machine as a worker by connecting `spl-daemon` to Console.

Download notebook Read quickstart

Notebook environment

curl -fsSL https://splime.io/downloads/spl-framework-cold-start.ipynb -o spl-framework-cold-start.ipynb
python3.13 -m venv .venv-spl-demo
source .venv-spl-demo/bin/activate
python -m pip install --upgrade pip
python -m pip install "spl-framework==0.1.0" ipykernel
python -m ipykernel install --user --name spl-demo --display-name "SPL demo"
jupyter lab spl-framework-cold-start.ipynb

Upgrade

Refresh workers without deleting daemon state.

Re-running an installer refreshes packages and service files while preserving the daemon home directory. Public installers download the SPL wheel bundle automatically; release builds should renew the wheelhouse and publish the matching bundle.

Upgrade a worker from a wheelhouse

./production/MVP/install-macos.sh --wheel-dir dist-packages --install-service --start
./production/MVP/install-linux.sh --wheel-dir dist-packages --install-service --start
.\production\MVP\install-windows.ps1 -WheelDir dist-packages -InstallService -Start

spl-daemon health
spl-daemon server-connection
spl-daemon server-machines

Renew release wheels

rm -rf dist-packages
./production/MVP/build-wheelhouse.sh dist-packages
cp dist-packages/public/splime-wheels-0.1.0.zip spl-frontend/downloads/splime-wheels-0.1.0.zip
cp dist-packages/public/splime-wheels-0.1.0.zip swpl-landing/downloads/splime-wheels-0.1.0.zip
python3.13 -m pip install --no-index --find-links dist-packages "spl-framework==0.1.0" "spl-daemon==0.1.0"

Remove-Item -Recurse -Force dist-packages -ErrorAction SilentlyContinue
.\production\MVP\build-wheelhouse.ps1 -OutDir dist-packages
Copy-Item dist-packages\public\splime-wheels-0.1.0.zip spl-frontend\downloads\splime-wheels-0.1.0.zip
Copy-Item dist-packages\public\splime-wheels-0.1.0.zip swpl-landing\downloads\splime-wheels-0.1.0.zip
py -3.13 -m pip install --no-index --find-links dist-packages "spl-framework==0.1.0" "spl-daemon==0.1.0"