Hugging Face's logo

hyperpixel123
/
bilta-gilata1

Text-to-Image
mflux
MLX
pixel-art
game-development
aseprite
pico-8
sprites
cli
apple-silicon
local
Model card Files
xet
 Community
bilta-gilata1
File size: 2,125 Bytes
ad2b6f0
 
 
 
 
 
f7b72c0
 
 
 
 
 
ad2b6f0
 
 
 
 
 
f7b72c0
 
 
 
050f5f1
f7b72c0
 
 
 
 
 
 
 
 
ad2b6f0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
f7b72c0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
ad2b6f0
f7b72c0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
---
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.