| --- |
| 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](https://coppermind.net) (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 |
|
|
