aboutsummaryrefslogtreecommitdiff

GANtools

CLI tool for rendering Artbreeder images locally!

Instructions

  1. Install Python 3 x64; it is very important that you get the 64 bit version or it will not work. If you are on Windows, be sure to check the "add to PATH" box in the installer. (Note for macOS users: if you are going to use brew to install python make sure you replace python with python3 and pip with pip3 in all of the following steps).
  2. Install git https://git-scm.com/downloads
  3. Install gantools
pip install git+https://gitlab.com/Vee9ahd1/gantools
  1. Read the help dialog
gantools -h

Example usage

gantools --username [email protected] --password mypassword123 --nframes 20 --keys 7968340a72eabab735d04dba 0416461072e5e22fd6d1637c c37d216dfd865aa7397db242

where the hexidecimal strings after --keys are the IDs found in an image's ganbreeder URL (e.g. https://ganbreeder.app/i?k=c37d216dfd865aa7397db242 has key: c37d216dfd865aa7397db242). You can list arbitrarily many keys; just be sure to increase your --nframes value to compensate (and be prepared for a longer render time).

Troubleshooting

How do I open the terminal emulator / command prompt?

Windows: press the Windows key and the r key at the same time and then run cmd.exe in the dialog that pops up.

Mac: run Terminal.app in your /Applications/Utilities directory.

Linux: install gentoo.

Syntax error / command not found / etc. on Windows

Did you check "add Python to PATH" in the installer? Probably not. Reinstall and be sure to do that.

Missing implementation that supports loader(*(\'...

Somehow the tfhub cache gets invalidated sometimes. IDK what causes it at that point but if you delete the tfhub_modules subdirectory it gives you the problem will be fixed (note: next time you run the script it will have to re-download the model so it will be slow).

Some arcane tensorflow error about missing symbols

This is usually a mismatch with your system's installed cuda and tensorflow. If I were to package this correctly, there would be a better solution, but for now just install gantools in a virtualenv:

pip install virtualenv
virtualenv ./gantools_venv
source gantools_venv/bin/activate # do this whenever you want to use gantools

SSL missing issuer certificate.

"urllib.error.URLError: <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1056)>"

AFAIK this is a MacOS only issue. Look in the Python3 install folder and you'll see a file called Install Certificates.command. Double click to run it. If that doesn't work (or if you installed Python with brew) try this:

pip3 install --upgrade certifi