miniOPs

Lightweight, polars-native MLOps CLI for training, versioning and deploying models locally, in Docker or on Google Cloud.

Status: pre-alpha. The current release contains only the command line skeleton (miniops --version and miniops version). The features and commands described below are the planned interface and may change.

Why miniOPs?

Most MLOps tooling is either a heavy platform you have to host, or a set of loosely connected libraries you have to glue together yourself. miniOPs aims for the middle ground:

• One workflow, three targets. The same commands train, register and deploy a model on your machine, in Docker containers, or on GCP.
• Polars-native. Data enters as a ready-made polars DataFrame (or a Parquet file) and predictions come back as polars. No pandas required.
• Zero servers by default. A solo user needs nothing but the CLI. Teams can share state through a cloud backend.
• Opinionated, not magical. You choose the framework and the target explicitly. miniOPs generates the template, installs the dependencies and handles the plumbing. The modelling decisions stay with you.
• Reproducible by design. Every model gets its own locked environment (uv), and every version records its code, data fingerprint, parameters and dependencies.
• Runs where you work. Linux, macOS and Windows, on x86_64 and arm64.

What miniOPs is not

miniOPs starts where data engineering ends. It does not ingest, clean, join or transform raw data, and it is not a feature store. It expects a prepared DataFrame and takes over from there: validating the input contract, splitting, training, evaluating, versioning, serving and monitoring.

Planned features

Frameworks

Targets

local and docker share the same state, so a model trained locally can be served in Docker right away. Moving a version to GCP (or back) is a single miniops migrate.

A taste of the planned CLI

pip install miniops-ml          # the command is `miniops`

miniops init
miniops new churn --flavor sklearn --target local
miniops train churn --data data/train.parquet
miniops report churn --version 1.0.0          # HTML report
miniops registry release churn --version 1.0.0
miniops deploy churn --version 1.0.0 --target docker
miniops deploy list
miniops registry bump churn --from 1.0.0 --minor   # new draft 1.1.0
miniops migrate churn --version 1.0.0 --to gcp     # copy to the team's GCP store

Roadmap

Contributing

The project is at an early stage, so the best way to help right now is to open an issue with ideas, use cases or feedback on the design, or start a thread in Discussions. For the development setup and guidelines, see CONTRIBUTING.md.

License

miniOPs is licensed under the Apache License 2.0.