Skip to content

alptezbasaran/dss-art

Repository files navigation

Cellular Automata Quilt

For a full explanation of how the math and code produce the visuals, see HOW_IT_WORKS.md.

Interactive, full‑screen cellular automata art that you can:

  • render to animated GIFs with Python/uv
  • explore live in the browser (click‑to‑seed, reset), either via Docker or GitHub Pages.

Local development with uv

Render the quilt GIF (non‑interactive, same as the original script):

uv run cellular_automata_quilt.py

This writes cellular_automata_quilt.gif into the project directory.

Docker interactive app

Build the image:

docker build -t cellular-art-web .

Run the full‑screen interactive app:

docker run --rm -p 8080:80 --name cellular-art-static cellular-art-web

Then open http://localhost:8080 and:

  • click/tap anywhere to seed the automaton from that point, or click and drag to draw a continuous trail
  • use the Reset button in the bottom‑right corner to clear the canvas

GitHub Pages

The interactive app is also available as a static HTML page:

  • index.html contains the entire client‑side implementation
  • .github/workflows/deploy.yml deploys index.html to GitHub Pages on each push to main

To enable Pages in GitHub:

  1. Go to Settings → Pages in the alptezbasaran/dss-art repo.
  2. Set Source to GitHub Actions.
  3. Push to main and wait for the Deploy to GitHub Pages workflow to succeed.

After that, your live URL will be shown in the Pages settings and in the workflow summary.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors