MiniKF

A fast and easy way to deploy Kubeflow on your laptop

MiniKF latest
version

A production-ready, full-fledged, local Kubeflow deployment that installs in minutes.

MiniKF is a fast and easy way to get started with Kubeflow. With just a few clicks, you are up for experimentation, and for running complete Kubeflow Pipelines.

To train at scale, move to a Kubeflow cloud deployment with one click, without having to rewrite anything.

Please see the official announcement and the rationale behind MiniKF.

Join the discussion on the #minikf Slack channel, ask questions, request features, and get support for MiniKF.

System requirements

For a smooth experience we recommend that your system meets the following requirements:

  • 12GB RAM
  • 2 CPUs
  • 50GB disk space

Operating systems

MiniKF runs on all major operating systems:

  • Linux
  • macOS
  • Windows

Prerequisites

Before installing MiniKF, you need to have Vagrant and VirtualBox installed on your laptop.

MiniKF installation

Open a terminal on your laptop, create a new directory, switch into it, and run the following commands to install MiniKF:

vagrant init arrikto/minikf
vagrant up

MiniKF will take a few minutes to boot. When this is done, navigate to http://10.10.10.10 and follow the on-screen instructions to start Kubeflow and Rok.

MiniKF upgrade

Here are step-by-step instructions for upgrading from a previous version:

  1. Upgrade the MiniKF box to the latest version: vagrant box update
  2. Ensure you have updated to the latest version: vagrant box list
  3. Upgrade the vagrant-persistent-storage plugin to v0.0.47 or later: vagrant plugin update vagrant-persistent-storage
  4. Destroy the VM: vagrant destroy
  5. Remove all local state. This will remove all of your customization in MiniKF (notebooks, pipelines, Rok snapshots):
    • [Windows] del minikf-user-data.vdi
    • [Linux/macOS] rm minikf-user-data.vdi
  6. Re-create your VM: vagrant up

Installation video

Here is a demo of installing MiniKF from scratch:

MiniKF
installation