Skip to main content

Fluksio

A node-based automation engine: flows, dashboards and batch runs, in one resident process with no infrastructure behind it.

pip install fluksio
fluksio serve

That is the whole installation — no Docker, no database server, no ports to open. It keeps a SQLite database, a git repository of your flows and an artifact store under ~/.fluksio, and prints an admin password once.

For data science

Your functions become nodes where they already live. Install Fluksio into the environment you work in and your nodes run on it — the packages are already there:

# myresearch/train.py
import fluksio
from fluksio import Port, node

@node(
    requires=["dataset", Port("lr", "float")],
    provides=[Port("loss", "float", stream=True), Port("weights", "artifact")],
    device="gpu", device_policy="prefer",
)
def fit(dataset, lr, epochs=25):
    for epoch in range(epochs):
        loss = step(...)
        yield {"loss": loss}          # published as it happens, kept as a series
    return {"weights": fluksio.save_artifact("weights.pt")}
# myresearch/pipeline.py
from fluksio import Flow, Port
from myresearch.train import fit

train = Flow("train", nodes=[prepare, fit, evaluate],
             inputs=[Port("lr", "float", initial=0.01)], outputs=["score"])
fluksio login --url http://127.0.0.1:8000
fluksio sync myresearch
fluksio run train --lr 0.05 --wait

The decorators return your functions untouched, so everything stays callable, testable and importable as what it was. A metric leaves through a declared port rather than a logging call, which is why there is no log_metric(): the run keeps the whole series, a chart can bind to it, and a downstream node can consume it.

What else it does

  • Flows — typed messages between nodes, wired by name, edited on a canvas or declared in code. Every change is a commit in a git repository you own.
  • Runs — an experiment and a CI-style job are the same entity. Parameters, seed, result, per-node timings, artifacts and the commit it ran at.
  • Dashboards — charts and controls bound to the same messages the flows carry, with no separate metrics pipeline.
  • Remote workerspip install fluksio-worker on the GPU box; it dials out over one websocket, so nothing there has to be reachable.

Links

Python 3.10 or newer, Linux or macOS.

License

Copyright (C) 2026 Melvin Strobl — GNU Affero General Public License v3.0 or later. Running a modified version over a network obliges you to offer its users the corresponding source (AGPL §13).

Download files

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

Source Distribution

fluksio-0.1.0.tar.gz (335.8 kB view details)

Uploaded Source

Built Distribution

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

fluksio-0.1.0-py3-none-any.whl (298.7 kB view details)

Uploaded Python 3

File details

Details for the file fluksio-0.1.0.tar.gz.

File metadata

  • Download URL: fluksio-0.1.0.tar.gz
  • Upload date:
  • Size: 335.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fluksio-0.1.0.tar.gz
Algorithm Hash digest
SHA256 5ded67180db32e589f7ab85e53cfde4f425c48613f46eeea258ee057286dce62
MD5 87f54e75202d76e8d1e812030cb7e2b9
BLAKE2b-256 f94c532159f66a8dffef67e0acb658a088dd9da505a255bbe8b1e96dc8160021

See more details on using hashes here.

File details

Details for the file fluksio-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: fluksio-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 298.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fluksio-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ab93e24d95f38e6f23c9e0184f2bd9df0df4804b39146080a591aa90ef12ba4e
MD5 a952897b19a68818c5490fe470332096
BLAKE2b-256 2e710578fd43d89619a7982dc4fb087ca73cf00cf19c14d938264e2570f041dd

See more details on using hashes here.

Release history Release notifications | RSS feed

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

This release

0.1.0 This release

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