Generative Art

A project that generates art using algorithms and randomization.

Introduction

Generative Art is a Python-based project designed to create stunning generative art using algorithms and randomization. The project leverages mathematical functions to generate unique images. The project includes the following key features:

  • Generates unique images using mathematical functions.
  • Automatically updates the README.md file with a grid layout of generated images.
  • Automates workflows for generating and deleting art using GitHub Actions.

Built With

Explanation

The project is using Samila to create generative art. Also, I'm using GitHub Actions to automate the generation of art based on a schedule. The generated images are stored in the output/images directory, and the README.md file is updated with a grid layout of these images. Besides, I also used nektos/act to run GitHub Actions locally. This allows me to test the workflow before pushing it to the repository.

Clone the repository

git clone https://github.com/KarChunT/generative-art.git
cd generative-art

Install dependencies

pip install -r requirements.txt

Run the script

python main.py --help # show help
python main.py generate-art # generate art
python main.py generate-readme # generate readme
python main.py delete-art # delete art

[Optional]: Run GitHub Actions locally

act -W '.github/workflows/delete_art.yaml' -e act/delete-art-payload.json
act -W '.github/workflows/generate_art.yaml' -e act/generate-art-payload.json

Written by

KarChunT

Last Updated

Mon Apr 28 2025

Languages

Python

Links