When takes more than 5 minutes,
you’ll want to instead.

Minihai is an open-source application for running notebooks server-side. Currently available with an integration for Jupyter Notebooks.

Get Started


Runs notebooks server-side.

Jupyter extension

Adds ‘run remote’ to your editor.

IntelliJ extension

Adds ‘run remote’ to your editor.

Check out Minihai on GitHub: github.com/valohai/minihai


Setting up Minihai

Install and run Minihai by running these commands:

# Install
pip install minihai

# Start the server
minihai start -h -p 8000

Now Minihai is up and running in!

Setting up Jupyhai

Jupyhai is the integration that enables you to run your Jupyter notebooks remotely on the Minihai host.

Start Jupyhai as a Jupyter Extension

Install Jupyhai as a Jupyter Notebook server extension by running these commands:

# Install
pip install jupyhai
jupyhai install

# Start the Jupyter notebook server
jupyter notebook

If the installation was successful, these new buttons will appear in the Jupyter notebook toolbar.

Configuration (optional)

You can configure Minihai with environment variables or a YAML-based configuration file.

Most configuration settings will be more conveniently set in a file. Set the MINIHAI_CONFIG environment variable, or start Minihai with the -c option to specify the path to the configuration file.


By default, Minihai doesn't require user authentication for logging in from the Jupyter notebook.

You can define user authentication as a simple mapping of usernames to passwords:

  arthur: teatime
  bob: almighty
  ford: towel