README.md

---
pipeline_tag: text-to-image
library_name: mflux
license: other
tags:
- pixel-art
- game-development
- aseprite
- pico-8
- sprites
- cli
- mlx
- apple-silicon
- local
---

# Bilta Gilata1

**Turn a sentence into palette-locked pixel art—locally on your Mac.**

Bilta Gilata1 is a free Apple-Silicon pixel-art CLI with 65 Aseprite palettes, reference-image guidance, deterministic seeds, and exact 16–256 px output. No API key, credits, or uploaded prompts.

![Bilta Gilata1 — local pixel art for Apple Silicon](assets/github-social-preview.png)

## Why use it?

- **Actually local:** generation runs on Apple Silicon.
- **Exact palettes:** output is quantized to one of 65 Aseprite palettes.
- **PICO-8 ready:** includes the official 16-color palette option.
- **Reference images:** guide composition and character appearance from a local file.
- **Reproducible:** reuse `--seed` to regenerate a composition.
- **Game-sized:** export at 16, 32, 48, 64, 128, or 256 pixels.

## Install

```bash
git clone https://huggingface.co/hyperpixel123/bilta-gilata1
cd bilta-gilata1
chmod +x install.sh bilta_gilata1.py
./install.sh
```

## Generate

```bash
.venv/bin/python bilta_gilata1.py "a tiny moon wizard" --palette pico-8 --size 128 --output wizard.png
```

Reference-guided generation:

```bash
.venv/bin/python bilta_gilata1.py "a forest adventurer" \
  --reference portrait.jpg --palette db16 --size 64 --output adventurer.png
```

Browse palettes:

```bash
.venv/bin/python bilta_gilata1.py --list-palettes
```

## Requirements

- Apple Silicon Mac
- Python 3.10+
- About 5 GB free for the first model download
- Internet required only for the initial download

## Gallery

| Sprite | Animation study | Palette output |
|---|---|---|
| ![Knight](assets/knight.png) | ![Knight walk](assets/knight-walk.gif) | ![Moon wizard](assets/moon-wizard.png) |

## Responsible distribution

This repository distributes the Bilta runtime and palette post-processor, not third-party model weights. Review `THIRD_PARTY_NOTICES.md`, including the upstream non-commercial checkpoint terms, before commercial use or redistribution.