🧩 PixAI — Pixel Art License & Generator

pip install pixai
pixai

PixAI adalah paket Python + CLI/GUI untuk membuat, mengelola lisensi, dan menyiapkan aset pixel art yang dihasilkan oleh AI serta lisensi karya AI bernama PixAI License.
kalian bisa melihat tata cara install dan langsung di gunakan yang sudah launching secara gratis dan kalian bisa kunjungi pada keterangan docs Royhtml

Gambar Pixai Tanpa harus punya basic gambar

Generated Gen Pixai

📋 Daftar Isi

1. Deskripsi Proyek
2. Kegunaan & Ruang Lingkup
3. Fitur Utama
4. Arsitektur & Algoritma
5. Persyaratan Sistem
6. Instalasi Lengkap
7. Cara Penggunaan
8. Pengelolaan Palet & Gaya
9. Ekspor & Integrasi
10. Lisensi PixAI (Lengkap)
11. Template LICENSE.txt
12. Watermark & Metadata AI
13. Troubleshooting
14. FAQ
15. Kontribusi
16. Catatan Rilis & Perubahan

Demo Video

📌 Deskripsi Proyek

PixAI menghadirkan pipeline lengkap untuk:

• Generate sprite, tileset, ikon, UI pixel art
• Refine (pixelate, quantize, outline) agar mengikuti estetika pixel art klasik.
• License-aware: menyertakan Penentu Lisensi otomatis (Personal/Commercial/Exclusive) + template kontrak.
• Audit: menambahkan watermark halus & metadata AI-generated.

Nama lisensi dan tool: PixAI.

🎯 Kegunaan & Ruang Lingkup

• Game 2D (JRPG, Roguelike, Platformer, Metroidvania).
• UI/UX retro, icon pack pixelated.
• Tileset kota, dungeon, overworld.
• NPC, monster, equipment, item drop, efek skill.
• Proyek komersial dan non-komersial dengan aturan lisensi jelas.

✨ Fitur Utama

• ✅ AI Pixel Generator: teks → sprite/tileset (ukuran 16×16, 24×24, 32×32, 48×48, 64×64, kustom).
• ✅ Style Controls: NES/GB/SNES/GENESIS-like palettes, dithering, outline otomatis, tileability.
• ✅ Batch & Seed: batch generation + seed untuk reproduksibilitas.
• ✅ License Engine: pilih skema Personal/Commercial/Exclusive, auto-isi LICENSE.txt & metadata.
• ✅ GUI & CLI: antarmuka sederhana + perintah terminal untuk CI/CD aset.
• ✅ Export Kit: PNG (indexed), spritesheet, Aseprite JSON, Godot/Unity importer hints.
• ✅ Audit AI: EXIF/XMP tag AI-generated by PixAI, watermark frekuensi-rendah opsional.

🧠 Arsitektur & Algoritma

📂 Alur Utama

graph TD
    A[Prompt / Gambar Acuan] --> B[Generative Core]
    B --> C[Guided Sampler]
    C --> D[Pixel Refinement]
    D --> E[Palette Quantization]
    E --> F[Tileability & Outline]
    F --> G[Export & Metadata]
    G --> H[License Engine]

🔧 Tahapan Algoritmik (Ringkas)

1. Generative Core: model difusi/transformer menghasilkan base image resolusi tinggi.
2. Guided Sampler: classifier-free guidance + kontrol ukuran target (mis. 64×64) via downscale.

3. Pixel Refinement:

4. Downscale → nearest-neighbor ke target grid.

5. Pixel-cleanup (morphology ringan) untuk menghindari noise.

6. Palette Quantization:

7. KMeans/MedianCut → palet terbatas (8/16/32 warna) sesuai preset (NES/GB/SNES/Custom).

8. Opsional Floyd–Steinberg dithering.

9. Tileability & Outline:

10. Seam-fix (wrap padding + Poisson-like blending pada grid) untuk tileset.

11. Edge-detect (Sobel/Scharr) → outline 1px adaptif.
12. Export & Metadata: simpan PNG indexed + sematkan XMP tag generator=PixAI.
13. License Engine: buat LICENSE.txt sesuai pilihan pemilik proyek.

🧪 Pseudocode Inti

function pixai_generate(prompt, size=64, palette="NES", colors=16, tileable=false, seed=None):
    base = generative_model.sample(prompt=prompt, seed=seed, hi_res=True)
    low = resample_nearest(base, target=(size,size))
    clean = pixel_cleanup(low)
    pal = choose_palette(preset=palette, n=colors)
    quant = quantize_image(clean, palette=pal, dithering="floyd_steinberg")
    if tileable:
        quant = make_tileable(quant)
    outlined = adaptive_outline(quant)
    write_png_indexed(outlined, metadata={"generator":"PixAI","ai":true})
    return outlined

🖥 Persyaratan Sistem

Tanpa Node/Cordova/Android SDK. Semua dependensi adalah Python-native.

📥 Instalasi Lengkap

1) Cek Python & PIP

python --version
pip --version

2) Instal PixAI

pip install pixai

3) Running Apps

pixai

Perintah ini untuk menjalankan aplikasi kalian bisa mencobanya

🕹 Cara Penggunaan

CLI (Command Line Interface)

# generate satu sprite
pixai generate \
  --prompt "knight with red cape, side view, chibi" \
  --size 64 \
  --palette snes --colors 24 \
  --outline 1 \
  --out knight_64.png

# batch 32x32 tileset, tileable
pixai generate --prompt "mossy stone floor, topdown" \
  --size 32 --tileable true \
  --palette gb --colors 8 \
  --grid 8x8 --out tileset_stone.png

# reproduksi hasil dengan seed
pixai generate --prompt "desert cactus small" --size 48 --seed 1234 --out cactus.png

Argumen Umum

• --size {16|24|32|48|64|...}
• --palette {nes|gb|snes|genesis|pico8|custom}
• --colors <n> (jumlah warna maksimum)
• --tileable true|false
• --outline 0|1 (ketebalan outline 1px)
• --seed <int>
• --grid AxB (susun ke spritesheet)
• --out <file.png>

GUI (Antarmuka Grafis)

1. Jalankan pixai gui.
2. Isi Prompt, pilih Size, Palette, Colors, dan opsi Tileable/Outline.
3. Klik Generate → pratinjau akan muncul.
4. Klik Export untuk menyimpan PNG + LICENSE.txt.

Engine Lisensi (CLI)

pixai license init --type commercial --owner "Studio Contoh" --project "RPG-Alpha" --author "PixAI"
# menghasilkan LICENSE.txt + metadata XMP pada setiap ekspor

🎨 Pengelolaan Palet & Gaya

• Preset: NES (54), GB (4), SNES (variasi), PICO-8 (16), Genesis (64-128).Angka dalam tanda kurung adalah contoh ukuran palet bawaan.
• Custom Palette: impor .gpl/.txt daftar RGB.
• Dithering: none, floyd_steinberg.
• Constraint: hard-limit warna saat quantize untuk konsistensi cross-asset.

📦 Ekspor & Integrasi

• PNG Indexed (palet tetap), spritesheet + JSON (Aseprite-like).
• Godot: aktifkan flags/mipmaps=false, filter=nearest.
• Unity: Filter Mode=Point (no filter), Compression=None, Max Size sesuai kebutuhan.

📜 Lisensi PixAI (Lengkap)

PixAI License mengikat aset pixel art yang dihasilkan melalui tool ini. Pilih salah satu mode saat ekspor: Personal, Commercial, atau Exclusive.

1) Personal

• Penggunaan non-komersial (proyek pribadi, prototipe, edukasi).
• Attribution wajib: "Pixel art generated with PixAI" di credit.
• Redistribusi aset dilarang kecuali sebagai bagian dari proyek.

2) Commercial

• Boleh digunakan dalam produk berbayar/beriklan.
• Attribution disarankan (opsional), namun metadata AI tidak boleh dihapus.
• Dilarang menjual aset sebagai asset pack berdiri sendiri.

3) Exclusive (add-on berbayar)

• Lisensi eksklusif untuk pemegang lisensi pada aset tertentu (hash aset tercantum).
• Tidak ada pihak ketiga lain yang boleh menggunakan aset yang sama.
• Attribution opsional; watermark dapat dihapus secara legal via kunci lisensi.

Ketentuan Umum

• Dilarang: konten ilegal, kebencian, pelanggaran IP pihak lain.
• AI Disclosure: setiap file menyertakan metadata ai-generated=true.
• Pembuktian Asal: checksum/hashing file disimpan di manifest proyek.
• Upstream Models: patuhi lisensi model dasar (jika ada) saat distribusi.

📄 Template LICENSE.txt

Salin, lalu sesuaikan variabel di pixai.

PixAI License v1.0

Project: PixAi
Owner: Dwi Bakti N Dev
Author/Tooling: PixAI (AI-generated)
Date: 27-08-2025

1. Grant of Rights

2. Rights are granted to use the listed pixel art assets according to the License Type above.

3. Restrictions

4. No reselling assets as standalone packs.

5. No unlawful, hateful, or infringing usage.

6. Attribution

7. Personal: Required ("Pixel art generated with PixAI").

8. Commercial/Exclusive: Recommended; may be omitted per project policy.

9. AI Disclosure & Metadata

10. Do not remove embedded XMP/EXIF tags identifying AI generation.

11. Exclusivity (Exclusive Only)

12. Exclusive license applies to assets listed by hash and is unique to the Owner.

13. Liability & Warranty

14. Provided "as is" without warranties; Owner responsible for compliance.

15. Governing Law

16. Determined by Owner's jurisdiction unless stated otherwise.

🏷 Watermark & Metadata AI

• Watermark: pola frekuensi-rendah pada channel luminance, tak kasat mata saat zoom 100%.
• Metadata: XMP fields creator=PixAI, generator=PixAI, ai-generated=true, license=<type>.
• Manifest: pixai_manifest.json berisi daftar file + SHA256 untuk audit.

🛠 Troubleshooting

❓ FAQ

• Apakah PixAI perlu internet? Tidak, model dapat di-cache lokal setelah unduhan awal.
• Bisa impor gambar sketsa? Ya, gunakan --init <file> untuk image-to-pixel.
• Legal untuk komersial? Ya, pilih Commercial/Exclusive dan ikuti syarat lisensi.

🤝 Kontribusi

• Laporkan isu/fitur lewat issue tracker.
• PR: sertakan before/after dan seed agar dapat direproduksi.
• Tambahkan preset palet baru di palettes/ + dokumentasi.

🗒 Catatan Rilis & Perubahan

• v1.0: Rilis awal PixAI yang sangat menakjubkan yang membungkam programing

Ringkasan Perubahan Besar: Semua instruksi Cordova/Android/Gradle dihapus. Diganti dengan panduan instalasi PixAI, algoritma generatif, pipeline pixel-art, lisensi baru, dan template LICENSE.txt.

🚀 Selamat Berkarya dengan PixAI!