Python CLI

Sprite Foundry for Star Freight.

Generate, review, and export 8-direction pixel sprites with normal and depth maps — all from a single CLI.

Get started See the pipeline

Clone

git clone https://github.com/mcp-tool-shop-org/sprite-foundry.git

Init

python -m foundry init

Export

python -m foundry export <run_id>

Pipeline

Five stages from concept to game-ready sprite pack.

ComfyUI Generation

SDXL + pixel-art-xl LoRA + ControlNet (Depth + Canny). 8 directions per subject with morphology variants for non-humanoid body plans.

SQLite Registry

Append-only lifecycle tracking with 13 states, reject codes, regen lineage, and full provenance — every decision is auditable.

Godot Finish Lab

4 lighting states × 8 directions = 32 captures per subject. Normal maps verified under moonlight, torchlight, and particle effects.

Deterministic Export

SHA-256 checksums, frozen contract v1.0.0, manifest.json with provenance. Consumers validate schema before loading.

20 Production Packs

7 crew, 6 creature, 3 hostile, 2 authority, 2 civilian — all finish-accepted with zero contract violations.

Morphology System

Arthropod, quadruped, and winged body families via depth/edge reference images for non-standard character shapes.

Usage

Register a subject

python -m foundry subject-add sera_vale "Sera Vale" \
  --role crew --consumer star-freight

Review and export

# Check pipeline status
python -m foundry status

# Accept a finished run
python -m foundry batch-accept 

# Export to deterministic pack
python -m foundry export

Export contract (frozen)

exports/{subject_slug}/{run_id}/
├── albedo/    8 × 48px transparent PNGs
├── normal/    8 × matching normal maps
├── depth/     8 × matching depth maps
├── preview/   contact sheet
└── manifest.json  (SHA-256, provenance)