MiniKF

A fast and easy way to deploy Kubeflow on your laptop

MiniKF latestversion

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

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

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

Please see the officialannouncementand the rationale behind MiniKF.

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

To join the Kubeflow Slack workspace, please request aninvite.

System requirements

For a smooth experience we recommend that your system meets thefollowing 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 VirtualBoxinstalled 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:

  1. vagrant init arrikto/minikf
  2. vagrant up

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

MiniKF upgrade

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

  • Upgrade the MiniKF box to the latest version:
  1. vagrant box update
  • Ensure you have updated to the latest version:
  1. vagrant box list
  • Upgrade the vagrant-persistent-storage plugin to v0.0.47 or later:
  1. vagrant plugin update vagrant-persistent-storage
  • Destroy the VM:
  1. vagrant destroy

  • 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
  • Re-create your VM:
  1. vagrant up

End-to-end example on MiniKF

Notebooks & Kubeflow Pipelines on the new MiniKF. Run an e2e ML pipelinefollowing thistutorial.

Installation video

Here is a demo of installing MiniKF from scratch:

MiniKFinstallation

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Last modified 12.10.2019: Update the MiniKF guide (#1229) (56223c26)