Skip to content
Commands using the Docker Hub HTTPS API
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


This repository contains Python scripts for interacting with Docker Hub without needing the Docker client itself.

It interacts exclusively with the Docker Hub HTTPS API.

Pull a Docker image in HTTPS

python hello-world

python alpine:3.9

python kalilinux/kali-linux-docker


  • Takes the default manifest (independant of the architecture)
  • Only support v2 manifests (not sure if someone need to retrieve v1 manifests)

Well known bugs

2 open bugs which shouldn't affect the efficiency of the script nor the pulled image:

  • Unicode content (for example \u003c) gets automatically decoded by json.loads() which differs from the original Docker client behaviour (\u003c should not be decoded when creating the TAR file). This is due to the json Python library automatically converting string to unicode.
  • Fake layers ID are not calculated the same way than Docker client does (I don't know yet how layer hashes are generated, but it seems deterministic and based on the client)
You can’t perform that action at this time.