https://github.com/bentatum/tenk

A framework for 10k pfp art projects
https://github.com/bentatum/tenk

generative-art nfts pfp

Last synced: over 1 year ago
JSON representation

A framework for 10k pfp art projects

• Host: GitHub
• URL: https://github.com/bentatum/tenk
• Owner: bentatum
• License: mit
• Created: 2022-07-29T22:27:05.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2025-02-01T19:29:13.000Z (over 1 year ago)
• Last Synced: 2025-03-28T19:37:47.232Z (over 1 year ago)
• Topics: generative-art, nfts, pfp
• Language: TypeScript
• Homepage: https://tenk-jet.vercel.app
• Size: 1.81 MB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

          
![Statements](https://img.shields.io/badge/statements-100%25-brightgreen.svg?style=flat)

![Branches](https://img.shields.io/badge/branches-100%25-brightgreen.svg?style=flat)

![Functions](https://img.shields.io/badge/functions-100%25-brightgreen.svg?style=flat)

![Lines](https://img.shields.io/badge/lines-100%25-brightgreen.svg?style=flat)

# tenk

Generative art projects made simple.

## Setup

tenk cli uses `node-canvas` to render pngs. If you encounter errors upon installation, check if you have the required packages. https://github.com/Automattic/node-canvas#installation.

## Get Started

Create a directory with a folder called `layers`. Each layer needs to be a folder with image files.

`cd` to your project folder in your terminal and type `npx tenk`. Images are rendered to the `.tenk` folder next to `layers`.

### Layer Ordering

Since layers are stacked in alphabetical order, you can control the order in which they appear by prefixing them with a number and an underscore. If `tenk` sees a number with an underscore as the first characters in your layer's directory name, it will remove it for you in the generated metadata.

```

layers/

  01_Background

  02_Body

  03_Eyes

  04_Hair

```

### Rarity

Layers have a property called `odds` that determines the likelyhood that it will be rendered or not. A lower number means rare, a higher number means common. You can define a layer's odds of appearing by appending a `#{percent value}` to the end of your file. If nothing is defined, it will always render.

For example, in the following directory structure Hair will appear 85% of the time and Jewlery will only appear 10% of the time.

```

layers/

  01_Background

  02_Body

  03_Eyes

  04_Hair#85

  05_Jewlery#10

```