Generate simple random pixel avatars from the command line or from Go code.

• Symmetric pixel-art avatar generation.
• CLI and importable Go package.
• Configurable grid dimensions, output size, and output file.
• Optional seed for reproducible avatars.
• Local Taskfile commands for run, test, example, and release builds.

Install the CLI:

go install github.com/ethercod3/goAvatar/cmd/goavatar@latest

Generate a 500px avatar with a 5x5 grid:

goavatar -s 500 -d 5 -o avatar.png

For local development:

task run -- -s 500 -d 5 -o avatar.png

goavatar -s <size> -d <dimensions> [-o <output>] [--seed <seed>]

package main

import (
	"image/png"
	"log"
	"os"

	"github.com/ethercod3/goAvatar/avatar"
)

func main() {
	options := avatar.Options{
		Dimensions: 5,
		FileSizePx: 500,
		Seed:       42,
	}

	img, err := avatar.New(options)
	if err != nil {
		log.Fatal(err)
	}

	file, err := os.Create("avatar.png")
	if err != nil {
		log.Fatal(err)
	}
	defer file.Close()

	if err := png.Encode(file, img); err != nil {
		log.Fatal(err)
	}
}

For direct file output:

err := avatar.Save("avatar.png", avatar.Options{
	Dimensions: 5,
	FileSizePx: 500,
	Seed:       42,
})

This project uses Task for common commands.

Equivalent Go commands:

go test ./...
go build ./...
go run ./cmd/goavatar -s 500 -d 5 -o avatar.png

Build cross-platform binaries:

nu scripts/build.nu

The script writes release artifacts to dist/, which is ignored by Git.