NFT Image Generator

Learn how to generate NFT images and upload them to IPFS.

What is NFT Image Generator?

NFT Image Generator is a Github project created by the user Sem. It uses a Python script to generate NFT images and then upload them to IPFS. The original version of this project has been forked and edited to use Filebase instead of the original IPFS pinning provider that was used.

Read below to learn how to generate NFT images and upload them to IPFS.


1. Start by cloning the project’s repository:

git clone

2. Then install the dependencies:

pip3 install -r requirements.txt.

3. Navigate to the Filebase Access Keys page, then view the IPFS Pinning Service API Endpoint.

Click the drop-down menu for 'Choose Bucket to Generate Token', then choose the IPFS Filebase Bucket you want to use.

4. Then copy the generated Secret Access Token:

5. Open config.json and put the Secret Access Token value in the api_key configuration.

6. Edit the config to match your workflow and make sure there is a sequential number at the beginning of each folder to represent the order of layers.

Make sure your file structure looks something like this:

├─ config.json
├─ 1 background/
│  ├─ red.png
│  ├─ green.png
│  ├─ blue.png
├─ 2 body/
│  ├─ female.png
│  ├─ male.png
│  ├─ zombie.png
├─ 3 eyes/
│  ├─ sun_glasses.png
│  ├─ normal_eyes.png
│  ├─ vr_glasses.png

You can get some sample image files to use here.

7. Then, run the script with the command:


If you have any questions, please join our Discord server, or send us an email at

Last updated