Skip to content
github-actions[bot] edited this page Jun 12, 2026 · 11 revisions

MLOX Logo

Welcome to the MLOX Wiki

Deploy and manage ML/AI infrastructure on your own servers. Slothfully simple.

Servers, Docker, Kubernetes, databases, workflows, model serving, data services, tracking, and monitoring, with your product at the center. Managed in one place and connected by design.


Why MLOX?

ML/AI infrastructure is fragmented. Setup is painful, managed platforms are expensive, and vendor lock-in limits your choices.

MLOX brings the infrastructure around your product into one connected system. It manages servers, sets up Docker and Kubernetes clusters, deploys open-source services, stores secrets, and wires dependencies across databases, workflows, experiment tracking, model serving, data services, and monitoring.

Use the Web UI, TUI, or CLI to operate the same inspectable, configuration-driven core. MLOX is built for solopreneurs, startups, and small teams that want to focus on their product instead of assembling and maintaining infrastructure.

It's for engineers who prefer thoughtful systems over chaos. Backed by open source. Powered by sloths.


Quick Navigation

Page Description
Architecture Codebase walkthrough for human contributors
Installation Setup from scratch (local, Docker, Kubernetes)
Contributing How to contribute to MLOX
Troubleshooting Known setup and runtime issues with fixes and workarounds
Services Catalog All supported MLOps services
Plugin Guide External service and server config plugins

What Can You Do with MLOX?

Area What's included
Infrastructure Add, remove, and tag servers; use Native, Docker, or Kubernetes execution; spin up single- or multi-node clusters
Connectors Integrate externally hosted services such as BigQuery, Cloud Storage, Sheets, and GCP Secret Manager
Services Deploy, manage, and remove services; centralize secrets; wire dependencies between services
Applications Import repositories and deploy your product alongside its supporting services
Code busysloths-mlox PyPI package with client integrations, SDK helpers, and example snippets
Lifecycle Management Migrate, upgrade, export, and decommission services (planned)

Services Catalog

Category Services Status
ML Platforms MLflow 2.x, MLflow 3.x, Airflow 2.x, Airflow 3.x Functional
Model Serving MLflow MLServer, MLflow Gateway Functional
LLMs & Inference LiteLLM, Ollama Functional
Vector & Feature Stores Milvus, Feast Functional
Data & Streaming PostgreSQL, Redis, MinIO, Kafka Functional
Observability InfluxDB, OpenTelemetry Functional
Secrets & Access OpenBao, Tiny Secret Manager, Registry 3 Functional / Beta
Kubernetes Add-ons Kubernetes Dashboard, Headlamp, KubeApps Experimental
Cloud Integrations GCP (BigQuery, Cloud Storage, Sheets, Secret Manager) Functional
Source Control GitHub repository import Beta
Applications Repository Docker Deploy Beta

Architecture at a Glance

CLI     TUI     Streamlit Web UI     Other UIs
  \      |             |                /
   \     |             |               /
    +----+-------------+--------------+
                    |
                    v
             `ProjectWorkspace`
          stateful mutation boundary
                    |
                    v
     internal state + SQLCipher repository
             /                               \
            v                                 v
 embedded SQLCipher storage                `Infrastructure`
 (metadata + topology + secrets)      topology for one project
                                            |
                                            v
                           `Bundle` = compute/server + services[*]
                                      |
                                      v
                    execution via `mlox/executors.py` + `mlox/execution/*`

ProjectWorkspace exposes the shared mutation and direct SDK API. It loads internal state containing metadata and Infrastructure, and commits both atomically to the encrypted project file. CLI commands open a workspace per invocation; the TUI and Web UI retain one in runtime state.

Service and server definitions remain inspectable and configuration-driven, while execution is handled consistently across Native, Docker, Kubernetes, and connector backends.

β†’ Read the full Architecture page for a deep dive.


Quickstart

# 1. Install Task (https://taskfile.dev/installation/)

# 2. Clone
git clone https://github.com/BusySloths/mlox.git && cd mlox

# 3. Set up environment (creates conda env 'mlox-dev' with Python 3.12.5)
task first:steps

# 4. Launch the Web UI
task ui:streamlit

# 5. Or try the CLI
task ui:cli CLI_ARGS="--help"

See the Installation wiki page or docs/INSTALLATION.md for Docker and Kubernetes setup.


Project Status

Native, Docker, and Kubernetes execution, connector integrations, and the major services are functional. The project has been accepted at CAIN 2026.

We welcome contributors, users, and honest feedback.


Documentation Index

Document Link
Architecture (humans) Architecture wiki page Β· docs/ARCHITECTURE_HUMANS.md
Architecture (agents) docs/ARCHITECTURE_AGENTS.md
Installation Guide docs/INSTALLATION.md
Contributing Guide CONTRIBUTING.md
Workflow Quick Reference docs/WORKFLOW_QUICK_REFERENCE.md
Plugin Guide docs/PLUGIN_CONFIGS.md
API Docs busysloths.github.io/mlox/docs
Website mlox.org

License

MLOX is open-source under the MIT License.


Powered by sloths. πŸ¦₯

Clone this wiki locally