Skip to main content

splime

Reuse Python functions across projects without rewriting or redeploying them.

splime turns trusted Python functions into versioned, portable nodes that can be reused across projects and executed locally or remotely. You publish a function to a private library once, then any project can call it by name, run it where the data or the hardware lives, and read back the result and artifacts — without copying code or redeploying.

  • Python-first. Plain Python functions and pipelines, no DSL to learn.
  • Reuse-first. Publish once, call by name from anywhere.
  • Private-team-first. Your own libraries and workers, with explicit ownership and scoped access.
  • Local or remote. The same call runs on your machine during development, or on a private worker that has the data, the GPU, or the credentials.

splime is a private node registry and execution layer — not a workflow orchestrator, a scheduler, or a public marketplace. It does not replace Airflow, Prefect, or Temporal.


Requirements

  • Python 3.13+

Install

pip install splime

The distribution is named splime; the Python import package is spl.

Quickstart

1. Start the local daemon (it stores your objects and runs workers):

spl-daemon serve            # listens on http://127.0.0.1:8765 by default

2. Publish a function and call it — a plain SPLClient() is fully local and never contacts a server:

from spl import SPLClient

def daily_total(date: str) -> float:
    prices = {"2026-06-08": [11.0, 6.5, 24.5]}
    return sum(prices.get(date, []))

client = SPLClient()                       # local-first; no server contact
client.publish(daily_total, name="daily_total")

result = client.call("daily_total", kwargs={"date": "2026-06-08"})
print(result.mode)     # "local"
print(result.output)   # 42.0  (.output always yields the plain value;
                       #  for pipelines .value keeps the raw port dict)

That is the whole loop: define a function, publish it as a versioned node, then call it by name and get back the value (plus logs and any artifacts).

Run it where the data lives

The same call becomes a remote run when you point it at a library, an owner, or a target machine. This requires a connected splime server and a private worker; the local daemon builds an isolated environment on the worker before executing.

client = SPLClient(user_token="…", machine_token="…")   # connect the daemon to your server

result = client.call(
    "daily_total",
    kwargs={"date": "2026-06-08"},
    target_machine="gpu-box",        # hand the run to a private worker
)
print(result.mode)    # "server"

SPLClient() without tokens stays entirely local — connecting to a server is always optional.

Libraries

Libraries group versioned objects and control who can see and run them. Creating and curating libraries uses a server-connected client:

client.library.create("risk", display_name="Risk", visibility="private")
client.publish(risk_score, name="risk_score", library="risk")

# Grant scoped access to a teammate
client.library.grant("risk", "analyst1", scopes=["metadata:read", "objects:read", "execute"])

A library can also reference a live object from another library (add_reference, follows latest) or take an owned snapshot with provenance (copy_object).

Security & trust

splime runs code that you publish on purpose, on machines you control. It is built around:

  • explicit ownership of every published object,
  • scoped access grants per library (read metadata, read objects, execute),
  • private worker boundaries — the server coordinates, your own workers execute,
  • isolated environments built by the daemon before a run,
  • an auditable run history.

How it fits together

Piece What it does
spl.core Serializes Python functions and pipelines to a portable SPL/YAML form.
SPLClient The user-facing client: publish, call, manage libraries and runs.
spl-daemon A local runtime that stores objects, builds environments, and executes workers.

Development

git clone https://github.com/yastrebovks/splime
cd splime
pip install -e '.[test]'
pytest

Project status

Alpha (0.1.0). The API may change between releases. Feedback and issues are welcome at the issue tracker.

Links

License

Licensed under the Apache License 2.0.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

splime-0.1.5.tar.gz (165.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

splime-0.1.5-py3-none-any.whl (192.8 kB view details)

Uploaded Python 3

File details

Details for the file splime-0.1.5.tar.gz.

File metadata

  • Download URL: splime-0.1.5.tar.gz
  • Upload date:
  • Size: 165.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for splime-0.1.5.tar.gz
Algorithm Hash digest
SHA256 b5be5a069c6a032c9eda8b5e3196801e1850fd3c9f591448ec2632e66cd2e034
MD5 76834777bd4b07a7e647278b74744173
BLAKE2b-256 fa2b32efef10817fc55f49bcea5c1d9b77fb14aeb3d4188ea680f30eaab0cbca

See more details on using hashes here.

Provenance

The following attestation bundles were made for splime-0.1.5.tar.gz:

Publisher: publish-to-pypi.yml on yastrebovks/splime

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file splime-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: splime-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 192.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for splime-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 b2b8494dd61a7cac17e0b8b42cd0dfd323d9161ae33703df579d28bccb2cbf78
MD5 1cee63235d97b5708b0dea556c718021
BLAKE2b-256 0e4ec91b503f60f715a43266c83c2e156dda04073514531c015f54344b7b2871

See more details on using hashes here.

Provenance

The following attestation bundles were made for splime-0.1.5-py3-none-any.whl:

Publisher: publish-to-pypi.yml on yastrebovks/splime

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.4.9

2 files

0.4.8

2 files

0.4.7

2 files

0.4.6

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.0

2 files

0.3.0

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

This release

0.1.5 This release

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page