Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

HTCondor Python Bindings Tutorials

This repository contains various tutorials on using the HTCondor Python Bindings. The easiest way to get started is to launch the tutorials via Binder: Binder

If Binder is not working for some reason, please let us know. You can also try some of the alternate ways to access the tutorials listed below.

If you are a maintainer, see the file for instructions.

Other Ways to Access the Tutorials

If Binder isn't working, there are a few other ways to get the tutorials.

Run in a Docker Container (From DockerHub)

You can run the same Docker container used by Binder locally by running

docker run -it --rm -p 8888:8888 htcondor/python-bindings-tutorials:latest

After Docker pulls the image and starts it, you should see something like

[C 14:21:29.540 NotebookApp]

    To access the notebook, open this file in a browser:
    Or copy and paste one of these URLs:

Paste one of the URL options into your web browser and you'll be in a Jupyter Lab (the file method will not work, you must use one of the links). Use the file browser on the left side of the Lab interface to open index.ipynb.

Run in a Docker Container (From a Local Repository)

The Docker container that runs on Binder is defined by binder/Dockerfile. You can run this container locally.

Clone the repository:

$ git clone

Run the script (or run.cmd on Windows), which builds and runs the Docker image and container:

$ binder/

You'll see the output of the Docker image build, then the container will spin up and you'll see a message like above. Use it to connect to the Jupyter Lab and open index.ipynb.

Run on Bare Metal

Install your preferred version of HTCondor on your computer (

Clone the repository as above.

Install JupyterLab and the matching version of the Python bindings into your Python using pip:

$ pip install jupyterlab htcondor==<x.y>

where <x.y> is something like 8.9.

Run JupyterLab from the repository root:

$ jupyter lab

and use your web browser to access the Jupyter Lab and open index.ipynb as above.

You can’t perform that action at this time.