Windows

Getting the Inkscape plugins to run will likely need manual installation (see above). Note that Inkscape may come with its own Python. If you run into trouble or have better installation instructions please open a ticket on GitHub.

Native

Following steps are known to work under Windows 10/11 (64-bit):

  1. Go to https://www.python.org/downloads/windows/ and download the current stable “Windows x86-64 executable installer” for Python 3. When this guide was written, Python 3.7 was the current version.

    Screenshot of python.org with download of Python 3.7 (64-bit)
  2. Install Python 3 and make sure to check “Add Python 3.X to PATH” while doing so

    Screenshot of Python 3.7 (64-bit) installer with PATH checked
  3. Run the command pip install Markdown affine shapely qrcode (Note: If the command pip is not found, you probably forgot to add the Python installation to the PATH environment variable in step 2)

  4. Download Boxes.py as ZIP archive from GitHub

    Screenshot of download from Boxes.py project on GitHub
  5. Extract the ZIP archive (e.g. via the built-in Windows feature or other tools like 7-Zip)

    Screenshot of Windows tools to extract the ZIP archive
  6. Change into the folder for Boxes.py,

    e.g. with the command cd \Users\[USERNAME]\Downloads\boxes-master

  7. Run the development server with the command

    python scripts\boxesserver Note: You likely will be notified by your firewall that it blocked network access. If you want to use boxesserver you need to allow connections.

    Screenshot of command for running boxesserver and firewall notice
  8. Open the address http://localhost:8000/ in your browser and have fun :)

Additionally the command line version of Boxes.py can be used with the command python scripts\boxes.

Windows Subsystem for Linux

Another way of installing Boxes.py on Windows is to use the Windows Subsystem for Linux (WSL). This requires newer versions of Windows 10. Once it is installed (e.g. via the Ubuntu App from the Microsoft Store), the installation is identical to the installation on Linux systems.

Once wsl is installed, run it and enter the following commands:

  • cd ~

  • git clone https://github.com/florianfesti/boxes.git

  • cd ~/boxes

  • python3 -m pip install .

  • python3 ~/boxes/scripts/boxesserver

Screenshot of a browser window running Boxes.py locally on WSL