nft-generator-py
nft-generator-py is a simple script which programatically generates images using weighted layer files.
Getting Started
Clone the repository and install the requirements.
git clone https://github.com/Jon-Becker/nft-generator-py
cd nft-generator-py
python3 -m pip install -r requirements.txt
Create a configuration file, or use the build_configuration
command to create a configuration file from a directory of traits. For more information on configuration files, see Configuration.
CLI Options
The following commands are available:
Command | Usage | Description |
---|---|---|
generate |
python3 main.py generate --config <config> [options] |
Generates a set of images using the provided configuration file. |
build_configuration |
python3 main.py build_configuration --trait-dir <trait_dir> [options] |
Builds a configuration file from a directory of traits. |
validate |
python3 main.py validate --config <config> [options] |
Validates a configuration file. |
update_metadata |
python3 main.py update_metadata --image-path <config> [options] |
Updates the metadata files for all generated images at the provided --output path. |
Optional Arguments
Argument | Description |
---|---|
-o <output> , --output <output> |
The path to the directory where the generated images will be saved. |
-c <config> , --config <config> |
The path to the configuration file. |
--trait-dir <trait_dir> |
The path to the directory containing the trait images. |
-n <amount> , --amount <amount> |
The number of images to generate. |
-v , --verbose |
Enables verbose logging. |
--start-at <start_at> |
The number to start counting from when generating images. |
--allow-duplicates |
Allows duplicate images to be generated. |
--no-pad |
Disables zero-padding of tokenIds. |
-s <seed> , --seed <seed> |
The seed to use when generating images. Allows for reproducible results. |
Configuration
{
"layers": [
{
"name": "Background",
"values": ["Blue", "Orange", "Purple", "Red", "Yellow"],
"trait_path": "./trait-layers/backgrounds",
"filename": ["blue", "orange", "purple", "red", "yellow"],
"weights": [30, 45, 15, 5, 10]
},
...
],
"incompatibilities": [
{
"layer": "Background",
"value": "Blue",
"incompatible_with": ["Python Logo 2"],
"default": {
"value": "Default Incompatibility",
"filename": "./trait-layers/foreground/logo"
}
}
],
"baseURI": ".",
"name": "NFT #",
"description": "This is a description for this NFT series."
}
The config
object is a dict that contains configuration instructions that can be changed to produce different outputs when running the program. Within metadata files, tokens are named using the configuration's name
parameter, and described using the description
parameter.
- In ascending order, tokenIds are appended to the
name
resulting in NFT metadata names such as NFT #0001. - tokenIds are padded to the largest amount generated. IE, generating 999 objects will result in names NFT #001, using the above configuration, and generating 1000 objects will result in NFT #0001.
- As of
v1.0.2
, padding filenames has been removed.
The layers
list contains layer
objects that define the layers for the program to use when generating unique tokens. Each layer
has a name, which will be displayed as an attribute, values, trait_path, filename, and weights.
trait_path
refers to the path where the image files infilename
can be found. Please note that filenames omit .png, and it will automatically be prepended.weight
corresponds with the percent chance that the specific value that weight corresponds to will be selected when the program is run. The weights must add up to 100, or the program will fail.
The incompatibilities
list contains an object that tells the program what layers are incompatible with what. In the above configuration, A Blue Background layer
will never be generated with Python Logo 2.
layer
refers to the targeted layer.value
is the value of the layer that is incompatible with attributes within theincompatible_with
list.incompatible_with
is the list of incompatible layers that will never be selected whenlayer
has attributevalue
.- An optional
default
object can be provided to each incompatibility. This object will be selected 100% of the time if present and an incompatible layer is selected. Thedefault
object has avalue
andfilename
attribute.value
is the name of the default selection which will be displayed in the metadata.filename
is the path to the image file that will be used as the default selection.
Troubleshooting
- All images should be in .png format.
- All images should be the same size in pixels, IE: 1000x1000.
- The weight values for each attribute should add up to equal 100.
Contributing
Before contributing, make a new branch with the following format:
user/{username}/{description}
Your names should be descriptive of the changes you are making. For example, if you are adding a new command, your branch name might be user/jon-becker/some-new-command
.
Your code will be reviewed and require at least one approval before being merged into the main
branch.
Please follow this guide when writing commit messages. Messages should be descriptive and clean.