README.md

metadata

title: Cosmere Codex
emoji: ✨
colorFrom: yellow
colorTo: pink
sdk: gradio
sdk_version: 6.18.0
python_version: '3.13'
app_file: app.py
pinned: true
license: mit
short_description: Chat in character with the Shards of the Cosmere

✨ Cosmere Codex — Voices of the Shards

A stylized star map of the Cosmere. Click a planetary system to open a live, in-character conversation with the god-like Shard(s) that dwell there. Each Shard is performed by a small language model kept fully in voice — ask them anything and they answer, generated on the fly, in their own distinct character.

Built for the Hugging Face Build Small Hackathon (creative track, "Thousand Token Wood"). The AI is the experience: the running model is what brings each Shard to life.

The Shards

• Harmony (Scadrial) — the god who was once a mortal scholar, holding stability and ruin in balance.
• Odium (Roshar) — divine hatred that calls itself Passion and offers freedom from guilt.
• Cultivation (Roshar) — the patient gardener who prunes people toward growth.
• Devotion & Dominion (Sel) — two Splintered Shards, finishing each other's broken thoughts.
• Endowment (Nalthis) — the giver of Breath, watching what mortals make of her gifts.
• Autonomy (Taldain) — the many-faced Shard who will never tell you who it truly is.
• The Presence of Threnody — a cold, haunted system where the Shard is lost.

How it works

• Model: Qwen/Qwen3-8B (≤ 32B params) run in non-thinking mode for snappy, in-character replies. The model id lives in one easy-to-swap constant in app.py (alt: openbmb/MiniCPM4.1-8B).
• Serving: Hugging Face transformers on ZeroGPU (@spaces.GPU), using the tokenizer's chat template.
• Lore: each Shard's personality and key canon lives in its system prompt, so the model performs a fully specified character rather than relying on (and inventing) lore.

⚙️ Note: this Space requires GPU hardware (ZeroGPU). A 7–8B model will not run on the default free CPU Space — enable GPU under Settings → Hardware.

Attribution & disclaimer

Lore facts adapted from the Coppermind wiki (CC BY-NC-SA). This is an unofficial, non-commercial fan project — not affiliated with or endorsed by Brandon Sanderson or Dragonsteel. The Cosmere and its worlds are their creations.

Configuration reference: https://huggingface.co/docs/hub/spaces-config-reference