-
Notifications
You must be signed in to change notification settings - Fork 2
Home
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.
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.
| 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 |
| 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) |
| 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 |
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.
# 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.
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.
- π Open an issue
- π¬ Start a discussion
- π§ contact@mlox.org
| 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 |
MLOX is open-source under the MIT License.
Powered by sloths. π¦₯