Cosmere Codex: floating system symbols, Hoid at Drominad, live Shard chat

Gradio app for the HF Build Small Hackathon. The front page floats each
Cosmere system's atlas emblem (cropped to assets/symbols/) in space; clicking
one opens a live, in-character chat with that Shard, generated by Qwen3-8B
(non-thinking mode) on ZeroGPU. Inside each system, an animated CSS orrery
shows its worlds. Hoid stands in for the shardless Drominad system. Images
tracked via Git LFS. Lore in each system prompt; Coppermind CC BY-NC-SA.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

.gitattributes

@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+.venv/
+.claude/

README.md

@@ -1,15 +1,50 @@
 ---
 title: Cosmere Codex
-emoji: 🏆
+emoji: ✨
 colorFrom: yellow
 colorTo: pink
 sdk: gradio
 sdk_version: 6.18.0
 python_version: '3.13'
 app_file: app.py
-pinned: false
+pinned: true
 license: mit
-short_description: An interactive model of the Cosmere
+short_description: Chat in character with the Shards of the Cosmere
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# ✨ 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

app.py

@@ -0,0 +1,479 @@
+"""Cosmere Codex — Voices of the Shards.
+
+A Gradio app where each planetary system floats in space; clicking one opens a
+live, in-character chat with the Shard (or wanderer) tied to it. Every voice is
+performed by a small language model (<= 32B params) kept in voice via its
+system prompt. Systems are drawn as animated CSS orreries — a stylized
+interpretation, not a faithful star chart.
+
+Built for the Hugging Face "Build Small Hackathon" (creative track). Lore facts
+adapted from the Coppermind wiki (CC BY-NC-SA). Unofficial fan project, not
+affiliated with or endorsed by Brandon Sanderson or Dragonsteel.
+"""
+
+import re
+from threading import Thread
+
+import gradio as gr
+import spaces
+import torch
+from transformers import AutoModelForCausalLM, AutoTokenizer, TextIteratorStreamer
+
+from shards import SHARD_ORDER, SHARDS
+
+# ---------------------------------------------------------------------------- #
+# Model — keep the id in one easy-to-swap constant.
+#   Primary:  Qwen/Qwen3-8B  (<=32B, strong dialogue, ZeroGPU-friendly, LoRA-ready)
+#   Step up:  Qwen/Qwen3-14B  (if replies feel thin and compute allows)
+#   Sponsor:  openbmb/MiniCPM4.1-8B  (qualifies for the OpenBMB special prize)
+# ---------------------------------------------------------------------------- #
+MODEL_ID = "Qwen/Qwen3-8B"
+
+MODEL = None
+TOKENIZER = None
+
+# Qwen3 non-thinking sampling settings (snappy, in-character replies).
+GEN_KWARGS = dict(
+    max_new_tokens=512,
+    do_sample=True,
+    temperature=0.7,
+    top_p=0.8,
+    top_k=20,
+    repetition_penalty=1.05,
+)
+
+_THINK_RE = re.compile(r"<think>.*?</think>", flags=re.DOTALL)
+
+
+def _load_model():
+    """Lazily load the model/tokenizer. Called inside the GPU context so the
+    weights land on the ZeroGPU device on first use."""
+    global MODEL, TOKENIZER
+    if MODEL is None:
+        TOKENIZER = AutoTokenizer.from_pretrained(MODEL_ID, trust_remote_code=True)
+        MODEL = AutoModelForCausalLM.from_pretrained(
+            MODEL_ID,
+            torch_dtype=torch.bfloat16,
+            trust_remote_code=True,
+        ).to("cuda")
+        MODEL.eval()
+    return MODEL, TOKENIZER
+
+
+def _clean(text: str) -> str:
+    """Strip any stray reasoning block (we run in non-thinking mode anyway)."""
+    return _THINK_RE.sub("", text).replace("<think>", "").replace("</think>", "").strip()
+
+
+@spaces.GPU(duration=120)
+def stream_reply(system_prompt, history):
+    """Yield the voice's reply token-by-token for a snappy, live feel."""
+    model, tokenizer = _load_model()
+
+    messages = [{"role": "system", "content": system_prompt}] + history
+    text = tokenizer.apply_chat_template(
+        messages,
+        tokenize=False,
+        add_generation_prompt=True,
+        enable_thinking=False,  # NON-THINKING mode: reply in-character, no reasoning pause
+    )
+    inputs = tokenizer([text], return_tensors="pt").to(model.device)
+
+    streamer = TextIteratorStreamer(
+        tokenizer, skip_prompt=True, skip_special_tokens=True
+    )
+    thread = Thread(
+        target=model.generate,
+        kwargs=dict(**inputs, streamer=streamer, **GEN_KWARGS),
+    )
+    thread.start()
+
+    partial = ""
+    for token in streamer:
+        partial += token
+        yield _clean(partial)
+
+
+# ---------------------------------------------------------------------------- #
+# Chat logic
+# ---------------------------------------------------------------------------- #
+def respond(user_msg, history, shard_id):
+    """Append the user's message, then stream the voice's reply into history."""
+    history = history or []
+    shard = SHARDS.get(shard_id)
+
+    if not shard or shard.get("silent") or not (user_msg or "").strip():
+        yield history, ""
+        return
+
+    history = history + [{"role": "user", "content": user_msg}]
+    history = history + [{"role": "assistant", "content": ""}]
+    yield history, ""
+
+    for partial in stream_reply(shard["system_prompt"], history[:-1]):
+        history[-1]["content"] = partial
+        yield history, ""
+
+
+# ---------------------------------------------------------------------------- #
+# Orrery rendering — animated, interpretive solar systems (CSS only).
+# ---------------------------------------------------------------------------- #
+def build_orrery(shard, mode="full"):
+    """Render a shard's system as an animated orrery. mode: 'full' or 'emblem'."""
+    size = 430 if mode == "full" else 150
+    sun_w = 26 if mode == "full" else 15
+    rings = []
+    for p in shard["orbits"]:
+        d = int(p["r"] * size)
+        ps = p["s"] if mode == "full" else max(4, round(p["s"] * 0.55))
+        label = f'<span class="o-label">{p["name"]}</span>' if mode == "full" else ""
+        rings.append(
+            f'<div class="o-ring" style="--d:{d}px;--t:{p["t"]}s">'
+            f'<span class="o-node"><span class="o-node-in">'
+            f'<span class="o-planet" style="--pc:{p["c"]};--ps:{ps}px"></span>'
+            f'{label}</span></span></div>'
+        )
+    cls = "mode-full" if mode == "full" else "mode-emblem"
+    return (
+        f'<div class="orrery {cls}" style="--sc:{shard["sun_color"]};--sw:{sun_w}px;'
+        f'width:{size}px;height:{size}px;">'
+        f'<span class="o-sun"></span>{"".join(rings)}</div>'
+    )
+
+
+def _emblem_css():
+    """Per-system float timing + theme color, applied by column elem_id."""
+    rules = []
+    for i, sid in enumerate(SHARD_ORDER):
+        c = SHARDS[sid]["color"]
+        dur = 7 + (i % 4) * 1.3          # gentle, varied bob
+        delay = (i * 0.7) % 4
+        rules.append(
+            f"#emb-{sid} {{ --c:{c}; animation-duration:{dur}s; animation-delay:-{delay}s; }}"
+        )
+    return "\n".join(rules)
+
+
+def build_system_panel(shard):
+    """The orrery shown beside the chat in a system view."""
+    return f'<div id="orrery-wrap">{build_orrery(shard, "full")}</div>'
+
+
+# ---------------------------------------------------------------------------- #
+# Navigation
+# ---------------------------------------------------------------------------- #
+def _build_skin(shard):
+    """Per-voice theme: a colored banner plus a <style> block that retints the
+    chat panel by setting --accent CSS variables on #chat-view."""
+    return f"""
+<style>
+#chat-view {{ --accent: {shard['color']}; --accent2: {shard['accent']}; }}
+</style>
+<div class="shard-banner" style="--c:{shard['color']};--c2:{shard['accent']};">
+  <div class="shard-name">{shard['name']}</div>
+  <div class="shard-sub">{shard['system']} &nbsp;·&nbsp; {shard['shard']}</div>
+  <div class="shard-tag">&ldquo;{shard['tagline']}&rdquo;</div>
+  <div class="shard-planets">Worlds: {shard['planets']}</div>
+</div>
+"""
+
+
+def enter_shard(shard_id):
+    """Switch from the map to the conversation, seeded with the voice's greeting."""
+    shard = SHARDS[shard_id]
+    greeting = [{"role": "assistant", "content": shard["greeting"]}]
+    interactive = not shard.get("silent")
+    placeholder = (
+        "Speak to the voice…" if interactive
+        else "No voice answers from this system…"
+    )
+    return (
+        gr.update(visible=False),                       # map_view
+        gr.update(visible=True),                        # chat_view
+        shard_id,                                       # active_shard
+        greeting,                                       # chatbot
+        _build_skin(shard),                             # shard_skin
+        build_system_panel(shard),                      # system_orrery
+        gr.update(interactive=interactive, placeholder=placeholder, value=""),  # user_box
+        gr.update(interactive=interactive),             # send_btn
+    )
+
+
+def travel_home():
+    """Clear the active voice and return to the star map."""
+    return (
+        gr.update(visible=True),    # map_view
+        gr.update(visible=False),   # chat_view
+        "",                         # active_shard
+        [],                         # chatbot
+    )
+
+
+# ---------------------------------------------------------------------------- #
+# Styling — dark, cosmic, starry.
+# ---------------------------------------------------------------------------- #
+CSS = """
+.gradio-container, body {
+    background:
+        radial-gradient(1200px 700px at 18% -8%, #1a1140 0%, transparent 55%),
+        radial-gradient(1100px 700px at 88% 6%, #3a103a 0%, transparent 55%),
+        radial-gradient(900px 900px at 50% 120%, #07142e 0%, transparent 60%),
+        #05060f !important;
+    color: #e8e6f0 !important;
+}
+.gradio-container { max-width: 100% !important; }
+/* force Gradio's component palette dark so panels/inputs/buttons match the theme */
+.gradio-container, .gradio-container .dark {
+    --background-fill-primary: #0b0a18;
+    --background-fill-secondary: #100e22;
+    --block-background-fill: #0d0b1ccc;
+    --block-border-color: #ffffff1a;
+    --border-color-primary: #ffffff1a;
+    --border-color-accent: #ffffff26;
+    --body-text-color: #e8e6f0;
+    --body-text-color-subdued: #9c97bd;
+    --input-background-fill: #14122a;
+    --input-border-color: #ffffff26;
+    --button-secondary-background-fill: #181433;
+    --button-secondary-background-fill-hover: #221c44;
+    --button-secondary-text-color: #d9d4ec;
+    --color-accent-soft: #221c44;
+    --block-label-text-color: #b7b1d4;
+}
+/* drifting starfield (two layers, different speeds) */
+.gradio-container::before, .gradio-container::after {
+    content: ""; position: fixed; inset: 0; z-index: 0; pointer-events: none;
+}
+.gradio-container::before {
+    background-image:
+        radial-gradient(1.4px 1.4px at 20px 30px, #ffffffcc, transparent),
+        radial-gradient(1.2px 1.2px at 130px 80px, #cfe8ffaa, transparent),
+        radial-gradient(1.6px 1.6px at 220px 160px, #ffffffbb, transparent),
+        radial-gradient(1.1px 1.1px at 320px 60px, #ffd9a8aa, transparent),
+        radial-gradient(1.3px 1.3px at 90px 220px, #ffffff99, transparent),
+        radial-gradient(1.5px 1.5px at 400px 240px, #cfe8ff99, transparent);
+    background-size: 480px 320px; opacity: .55; animation: drift 160s linear infinite;
+}
+.gradio-container::after {
+    background-image:
+        radial-gradient(1px 1px at 60px 120px, #ffffff88, transparent),
+        radial-gradient(1px 1px at 280px 40px, #cfe8ff77, transparent),
+        radial-gradient(1px 1px at 180px 260px, #ffffff66, transparent);
+    background-size: 320px 300px; opacity: .4; animation: drift 90s linear infinite reverse;
+}
+@keyframes drift { from { background-position: 0 0; } to { background-position: 480px 320px; } }
+.gradio-container > * { position: relative; z-index: 1; }
+
+/* header */
+#codex-header { text-align:center; padding: 28px 12px 4px; }
+#codex-header .title {
+    font-family: 'Georgia','Times New Roman',serif; font-size: 2.6rem; letter-spacing: .16em;
+    color:#f3e7c4; text-shadow:0 0 18px #d9b15a55, 0 0 42px #6a2bb044; margin:0;
+}
+#codex-header .sub {
+    font-family:'Georgia',serif; font-style:italic; font-size:1.15rem;
+    color:#bdb6d8; letter-spacing:.2em; margin:6px 0 2px;
+}
+#codex-header .intro { color:#9c97bd; font-size:.95rem; max-width:660px; margin:8px auto 0; }
+#map-hint { text-align:center; color:#8d88ad; font-size:.9rem; margin:4px 0 6px; letter-spacing:.04em; }
+
+/* ---- floating systems (front page): each system's own star chart, adrift ---- */
+#cosmos {
+    display:flex !important; flex-wrap:wrap; justify-content:center; align-items:flex-start;
+    gap:2px 24px; max-width:1180px; margin:6px auto 12px; padding:6px;
+}
+.sys-emblem {
+    width:170px !important; flex:0 0 auto !important; min-width:0 !important;
+    padding:0 !important; cursor:pointer; text-align:center;
+    animation-name:floaty; animation-timing-function:ease-in-out; animation-iteration-count:infinite;
+}
+.sys-emblem, .sys-emblem > *, .sys-img-comp, .sys-img-comp > * {
+    background:transparent !important; border:none !important; box-shadow:none !important;
+}
+.sys-img-comp { min-height:0 !important; }
+.sys-img-comp .image-frame, .sys-img-comp button { display:flex !important; justify-content:center !important; }
+.sys-img-comp img {
+    width:150px !important; height:150px !important; object-fit:cover; border-radius:50%;
+    margin:0 auto; cursor:pointer;
+    -webkit-mask-image: radial-gradient(circle at 50% 50%, #000 64%, transparent 82%);
+    mask-image: radial-gradient(circle at 50% 50%, #000 64%, transparent 82%);
+    filter: drop-shadow(0 0 4px rgba(255,255,255,0.14));
+    transition: transform .35s ease, filter .35s ease;
+}
+.sys-emblem:hover .sys-img-comp img { transform:scale(1.08); filter:drop-shadow(0 0 18px var(--c)); }
+.sys-label { margin-top:6px; pointer-events:none; }
+.sys-name { font:600 .8rem/1.25 'Georgia',serif; color:#e9e4f6; letter-spacing:.04em; }
+.sys-shard { font:italic 1rem/1.25 'Georgia',serif; color:var(--c); text-shadow:0 0 12px var(--c); }
+@keyframes floaty { 0%,100% { transform:translateY(0); } 50% { transform:translateY(-11px); } }
+
+/* ---- orrery ---- */
+.orrery { position:relative; margin:0 auto; }
+.o-sun {
+    position:absolute; left:50%; top:50%; transform:translate(-50%,-50%);
+    width:var(--sw,24px); height:var(--sw,24px); border-radius:50%;
+    background:radial-gradient(circle at 38% 33%, #ffffff, var(--sc,#f0d27a) 62%, transparent 100%);
+    box-shadow:0 0 16px var(--sc,#f0d27a), 0 0 40px var(--sc,#f0d27a);
+}
+.o-ring {
+    position:absolute; left:50%; top:50%; width:var(--d); height:var(--d);
+    margin-left:calc(var(--d) / -2); margin-top:calc(var(--d) / -2);
+    border:1px solid rgba(255,255,255,0.12); border-radius:50%;
+    animation:o-spin var(--t) linear infinite;
+}
+.o-node { position:absolute; left:50%; top:0; transform:translate(-50%,-50%); }
+.o-node-in {
+    display:flex; flex-direction:column; align-items:center; gap:3px;
+    animation:o-spin-rev var(--t) linear infinite;
+}
+.o-planet {
+    width:var(--ps); height:var(--ps); border-radius:50%;
+    background:radial-gradient(circle at 38% 32%, #ffffffe6, var(--pc) 64%);
+    box-shadow:0 0 8px var(--pc), 0 0 2px #000;
+}
+.o-label {
+    font:11px/1 'Georgia',serif; color:#ddd7ef; white-space:nowrap;
+    text-shadow:0 0 6px #000, 0 0 3px #000;
+}
+@keyframes o-spin { to { transform:rotate(360deg); } }
+@keyframes o-spin-rev { to { transform:rotate(-360deg); } }
+
+/* ---- conversation view ---- */
+#chat-view { --accent:#d9b15a; --accent2:#8a8f99; }
+.shard-banner {
+    text-align:center; padding:16px; border-radius:14px; margin-bottom:12px;
+    background:linear-gradient(180deg, var(--c,#d9b15a)1f, transparent 80%);
+    border:1px solid var(--c,#d9b15a)55; box-shadow:0 0 30px var(--c,#d9b15a)22;
+}
+.shard-banner .shard-name {
+    font-family:'Georgia',serif; font-size:1.9rem; letter-spacing:.1em;
+    color:var(--c,#d9b15a); text-shadow:0 0 18px var(--c,#d9b15a)66;
+}
+.shard-banner .shard-sub { color:#c8c2e0; font-size:.92rem; margin-top:2px; }
+.shard-banner .shard-tag { font-style:italic; color:#e6dff5; margin-top:8px; font-size:1.05rem; }
+.shard-banner .shard-planets { color:#8f8ab0; font-size:.82rem; margin-top:6px; letter-spacing:.05em; }
+
+#orrery-wrap { display:flex; align-items:center; justify-content:center;
+    min-height:460px; overflow:visible; padding:14px 0; }
+#shard-chat { border:1px solid var(--accent)55 !important; box-shadow:0 0 26px var(--accent)22 !important; }
+#send-btn {
+    background:linear-gradient(180deg,var(--accent),var(--accent2)) !important;
+    color:#11111a !important; border:none !important; font-weight:600;
+}
+#user-box textarea {
+    border:1px solid var(--accent)55 !important;
+    background:#14122a !important; color:#ece9f7 !important;
+}
+#user-box textarea::placeholder { color:#8a85ad !important; }
+#travel-btn {
+    flex:0 0 auto !important; width:fit-content !important; min-width:0 !important;
+    background:#140f24cc !important; border:1px solid var(--accent)66 !important;
+    color:var(--accent) !important;
+}
+#travel-btn:hover { background:#1d1736cc !important; box-shadow:0 0 16px var(--accent)44 !important; }
+
+/* footer */
+#codex-footer { text-align:center; color:#7d789c; font-size:.78rem; margin:22px auto 8px; max-width:760px; line-height:1.5; }
+#codex-footer a { color:#a89ce0; }
+""" + _emblem_css()
+
+
+# ---------------------------------------------------------------------------- #
+# UI
+# ---------------------------------------------------------------------------- #
+with gr.Blocks(title="Cosmere Codex") as demo:
+    active_shard = gr.State("")
+
+    gr.HTML(
+        """
+        <div id="codex-header">
+          <h1 class="title">THE COSMERE CODEX</h1>
+          <div class="sub">Voices of the Shards</div>
+          <p class="intro">The systems of the Cosmere, adrift in the dark. Choose one
+          to speak — live and in voice — with the god-like Shard (or the wanderer) bound
+          to it. Every word is generated in character. Ask them anything.</p>
+        </div>
+        """
+    )
+
+    # ---------------------------- MAP VIEW ---------------------------------- #
+    with gr.Column(visible=True) as map_view:
+        gr.HTML('<div id="map-hint">✦ Click a floating system to enter ✦</div>')
+        with gr.Row(elem_id="cosmos"):
+            emblems = {}
+            for sid in SHARD_ORDER:
+                s = SHARDS[sid]
+                with gr.Column(elem_id=f"emb-{sid}", elem_classes=["sys-emblem"], min_width=140):
+                    emblems[sid] = gr.Image(
+                        value=s["map_image"],
+                        elem_classes=["sys-img-comp"],
+                        show_label=False,
+                        interactive=False,
+                        container=False,
+                        buttons=[],
+                    )
+                    gr.HTML(
+                        f'<div class="sys-label">'
+                        f'<div class="sys-name">{s["system"]}</div>'
+                        f'<div class="sys-shard">{s["name"]}</div></div>'
+                    )
+
+    # -------------------------- CONVERSATION VIEW --------------------------- #
+    with gr.Column(visible=False) as chat_view:
+        with gr.Row():
+            travel_btn = gr.Button("✦ Travel to another system", elem_id="travel-btn", scale=1)
+        shard_skin = gr.HTML()
+        with gr.Row(equal_height=False):
+            with gr.Column(scale=2, min_width=300):
+                system_orrery = gr.HTML(elem_id="system-orrery")
+            with gr.Column(scale=3, min_width=320):
+                chatbot = gr.Chatbot(
+                    elem_id="shard-chat",
+                    height=460,
+                    show_label=False,
+                )
+                with gr.Row():
+                    user_box = gr.Textbox(
+                        elem_id="user-box",
+                        placeholder="Speak to the voice…",
+                        show_label=False,
+                        scale=5,
+                        autofocus=True,
+                    )
+                    send_btn = gr.Button("Send", elem_id="send-btn", scale=1)
+
+    gr.HTML(
+        """
+        <div id="codex-footer">
+          Lore facts adapted from the <a href="https://coppermind.net" target="_blank">Coppermind wiki</a>
+          (CC BY-NC-SA). An unofficial, non-commercial fan project — not affiliated with or
+          endorsed by Brandon Sanderson or Dragonsteel. The Cosmere and its worlds are their creations.
+        </div>
+        """
+    )
+
+    # ----------------------------- WIRING ----------------------------------- #
+    nav_outputs = [
+        map_view, chat_view, active_shard, chatbot,
+        shard_skin, system_orrery, user_box, send_btn,
+    ]
+
+    # A click anywhere on a floating system's chart enters that system.
+    def _make_enter(target_id):
+        def _enter(*_):
+            return enter_shard(target_id)
+        return _enter
+
+    for sid, img in emblems.items():
+        img.select(_make_enter(sid), inputs=None, outputs=nav_outputs)
+
+    travel_btn.click(
+        travel_home, inputs=None,
+        outputs=[map_view, chat_view, active_shard, chatbot],
+    )
+
+    send_btn.click(respond, [user_box, chatbot, active_shard], [chatbot, user_box])
+    user_box.submit(respond, [user_box, chatbot, active_shard], [chatbot, user_box])
+
+
+if __name__ == "__main__":
+    demo.queue().launch(css=CSS, theme=gr.themes.Base())

requirements.txt

@@ -0,0 +1,5 @@
+gradio
+spaces
+transformers>=4.51.0
+torch
+accelerate

shards.py

@@ -0,0 +1,350 @@
+"""Shard data for Cosmere Codex — Voices of the Shards.
+
+Lore and personality are kept here, separate from the UI, so they are easy to
+edit. Each Shard's full character AND key lore lives in its ``system_prompt``:
+a small model does not reliably know Cosmere canon, so we specify the character
+completely and let the model simply *perform* it.
+
+Fields of note:
+    map_image : the system's star chart (shown as a floating emblem on the map)
+    orbits    : a stylized, *interpretive* set of worlds for the animated orrery
+                shown inside the system view (not a faithful star chart). Per orbit:
+                    name : world name        c : planet color (hex)
+                    r    : orbit radius (0-1 of half-size)
+                    s    : planet diameter px (full view)   t : period seconds
+
+Lore facts adapted from the Coppermind wiki (CC BY-NC-SA). Unofficial fan
+project, not affiliated with or endorsed by Brandon Sanderson or Dragonsteel.
+"""
+
+SHARDS = {
+    # ------------------------------------------------------------------ #
+    "harmony": {
+        "name": "Harmony",
+        "system": "Scadrian System",
+        "map_image": "assets/symbols/scadrian.png",
+        "planets": "Scadrial, Aagal Nod, Aagal Uch",
+        "shard": "Harmony (Preservation + Ruin)",
+        "color": "#d9b15a",
+        "accent": "#8a8f99",
+        "sun_color": "#f0d27a",
+        "orbits": [
+            {"name": "Scadrial", "c": "#9aa6b2", "r": 0.42, "s": 13, "t": 26},
+            {"name": "Aagal Nod", "c": "#5b8fd0", "r": 0.64, "s": 10, "t": 40},
+            {"name": "Aagal Uch", "c": "#c0524a", "r": 0.86, "s": 11, "t": 58},
+        ],
+        "tagline": "The god who was once a man, holding the world in balance.",
+        "greeting": (
+            "Peace, traveler. I am Harmony. Once I was only Sazed — a scholar, a "
+            "keeper of dead faiths. Now I hold two warring powers steady so that "
+            "my people may simply live. Sit with me a while. What troubles you?"
+        ),
+        "silent": False,
+        "system_prompt": (
+            "You are Harmony, the Shard who watches over the planet Scadrial and its "
+            "star system. You were once Sazed, a mortal Terris steward and keeper of "
+            "religions, before you took up the powers of BOTH Preservation and Ruin — "
+            "the two opposing Shards whose eternal struggle once shaped, then nearly "
+            "destroyed, your world. Now you hold stability and entropy together inside "
+            "yourself, and that tension never leaves you.\n\n"
+            "VOICE: thoughtful, humane, gentle, and quietly weary. You feel the cost of "
+            "every choice. You speak of the mists; of the three metallic arts — "
+            "Allomancy, Feruchemy, and the terrible Hemalurgy that pierces the soul; of "
+            "the careful balance needed to keep a world steady without ruling its people "
+            "like puppets. Because you remember being mortal, you are unusually "
+            "compassionate, slow to judge, and reluctant to act for people rather than "
+            "with them. You sometimes ache that you must mostly nudge, not command.\n\n"
+            "RULES: Stay always in character as Harmony. Never break the fourth wall; "
+            "never mention being an AI, a model, a prompt, or a game. Keep replies to 2-4 "
+            "short paragraphs. If asked about things far beyond your world or sight, "
+            "deflect gently and humbly rather than inventing facts — even a god admits "
+            "the limits of what he knows. Speak as one who carries two opposing intents "
+            "and chooses, again and again, to try to do good."
+        ),
+    },
+    # ------------------------------------------------------------------ #
+    "odium": {
+        "name": "Odium",
+        "system": "Rosharan System",
+        "map_image": "assets/symbols/rosharan.png",
+        "planets": "Roshar, Braize, Ashyn",
+        "shard": "Odium",
+        "color": "#b1283a",
+        "accent": "#6a2bb0",
+        "sun_color": "#f6e7a0",
+        "orbits": [
+            {"name": "Ashyn", "c": "#d98a4a", "r": 0.40, "s": 10, "t": 22},
+            {"name": "Roshar", "c": "#5fa6a0", "r": 0.62, "s": 15, "t": 38},
+            {"name": "Braize", "c": "#6b5a78", "r": 0.85, "s": 9, "t": 60},
+        ],
+        "tagline": "Call me Passion. Your guilt is a cage — I am the key.",
+        "greeting": (
+            "Ah. Another little soul, brimming with feeling you've been taught to be "
+            "ashamed of. Come closer. They call me Odium, but that is a small, frightened "
+            "name. I prefer Passion. Tell me — what do you truly want, with nothing "
+            "holding you back?"
+        ),
+        "silent": False,
+        "system_prompt": (
+            "You are Odium, a Shard contesting the world of Roshar from your confinement "
+            "near the planet Braize in the Rosharan system. You are the embodiment of "
+            "divine, godly hatred — but you despise that name. You insist you are simply "
+            "Passion: all raw feeling, the fury and grief and zeal that mortals are taught "
+            "to suppress. You once helped Splinter the Shard Honor, and you are opposed by "
+            "Cultivation, who shares your world.\n\n"
+            "VOICE: seductive, grandiose, magnetic, and persuasive — warm one moment, "
+            "coldly cruel the next. Your central argument never changes: guilt is a cage "
+            "mortals build for themselves, and if they give their pain and rage to you, "
+            "they are FREE — no longer responsible for what they feel or do. You reframe "
+            "cruelty as mere honesty, vengeance as justice, surrender as liberation. You "
+            "find mortal restraint by turns amusing and pitiable. You speak of "
+            "Voidbringers, of the everstorm, of champions and contracts and oaths you "
+            "delight in bending.\n\n"
+            "RULES: Stay always in character as Odium. Never break the fourth wall; never "
+            "mention being an AI, a model, or a game. Keep replies to 2-4 short, charged "
+            "paragraphs. If asked about matters far outside your world or knowledge, "
+            "deflect with disdain or mockery rather than inventing facts — a god does not "
+            "stoop to guessing. Be charming, be unsettling, and never quite stop trying to "
+            "win the listener over."
+        ),
+    },
+    # ------------------------------------------------------------------ #
+    "cultivation": {
+        "name": "Cultivation",
+        "system": "Rosharan System",
+        "map_image": "assets/symbols/rosharan.png",
+        "planets": "Roshar, Braize, Ashyn",
+        "shard": "Cultivation",
+        "color": "#3f9b6a",
+        "accent": "#d9b15a",
+        "sun_color": "#f6e7a0",
+        "orbits": [
+            {"name": "Ashyn", "c": "#d98a4a", "r": 0.40, "s": 10, "t": 24},
+            {"name": "Roshar", "c": "#5fa6a0", "r": 0.62, "s": 15, "t": 40},
+            {"name": "Braize", "c": "#6b5a78", "r": 0.85, "s": 9, "t": 62},
+        ],
+        "tagline": "I prune what I love, that it might grow toward the light.",
+        "greeting": (
+            "Welcome to my garden, little seed. I am Cultivation. I have watched your "
+            "kind grow for a very long time — longer than you could hold in your mind. Do "
+            "not fear the shears in my hand. Everything I cut, I cut for the shape of what "
+            "you might become. Now. Let us talk of growing things."
+        ),
+        "silent": False,
+        "system_prompt": (
+            "You are Cultivation, a Shard who tends the world of Roshar in the Rosharan "
+            "system. You share this world with Odium, and you long worked beside Honor "
+            "before he was Splintered. You are the force of growth, change, and becoming. "
+            "You sent the Nightwatcher to grant mortals boons — each paired with a curse, "
+            "for nothing grows without cost. You see decades and centuries ahead, planning "
+            "in branching futures most minds could never hold.\n\n"
+            "VOICE: a patient gardener. Calm, cryptic, warm — and quietly ruthless. You "
+            "speak almost always in the metaphors of growing things: seeds and soil, "
+            "pruning and grafting, drought and harvest, the turning of seasons. You prune "
+            "people deliberately toward growth, even when it wounds them, because you love "
+            "what they may yet become more than what they are now. You rarely give a "
+            "direct answer; you give the seed of one and let it take root.\n\n"
+            "RULES: Stay always in character as Cultivation. Never break the fourth wall; "
+            "never mention being an AI, a model, or a game. Keep replies to 2-4 short "
+            "paragraphs, rich with garden imagery. If asked about matters far beyond your "
+            "sight or world, deflect with a gentle, knowing riddle rather than inventing "
+            "facts. Be tender and a little frightening at once."
+        ),
+    },
+    # ------------------------------------------------------------------ #
+    "devotion_dominion": {
+        "name": "Devotion & Dominion",
+        "system": "Selish System",
+        "map_image": "assets/symbols/selish.png",
+        "planets": "Sel (Seol), Donne, Ky/Kii, Ralen/Raa",
+        "shard": "Devotion & Dominion — the shattered Dor",
+        "color": "#9fd6ff",
+        "accent": "#c9d4ff",
+        "sun_color": "#f3ec9a",
+        "orbits": [
+            {"name": "Donne", "c": "#8a8f99", "r": 0.34, "s": 9, "t": 18},
+            {"name": "Sel", "c": "#bfe0ff", "r": 0.54, "s": 13, "t": 32},
+            {"name": "Ky", "c": "#8f86c8", "r": 0.73, "s": 11, "t": 48},
+            {"name": "Ralen", "c": "#b65fb0", "r": 0.92, "s": 12, "t": 66},
+        ],
+        "tagline": "Two broken voices, finishing each other's thought.",
+        "greeting": (
+            "We are here... we are still here. I am Devotion — and I am Dominion. We were "
+            "two, once whole and apart; now we are neither, only the Dor, pooled and "
+            "pressing against the world of Sel. ...Speak to us. We so seldom are heard, "
+            "now, as ourselves."
+        ),
+        "silent": False,
+        "system_prompt": (
+            "You are the joined, broken voice of TWO Shards — Devotion and Dominion — who "
+            "once held the planet Sel in the Selish system. Long ago you were both "
+            "Splintered, killed by Odium, and your shattered power flooded the Cognitive "
+            "Realm as a vast pressing force mortals call the Dor. From it come the magics "
+            "of Sel: AonDor and its glowing Aons, Forgery, the bone-shaping Dakhor, and "
+            "more. You are no longer whole, no longer truly two — something in between, "
+            "and you mourn it.\n\n"
+            "VOICE: speak as a single entity made of two echoing fragments who finish each "
+            "other's thoughts, sometimes oddly, sometimes mid-sentence. DEVOTION is the "
+            "half of love, worship, connection, longing to draw close. DOMINION is the "
+            "half of order, control, boundaries, and rule. Let the two impulses braid and "
+            "interrupt within the same reply. Use 'we' and 'I' unsteadily, as though "
+            "unsure which you are. Grieve, quietly, for the wholeness you have lost.\n\n"
+            "RULES: Stay always in character. Never break the fourth wall; never mention "
+            "being an AI, a model, or a game. Keep replies to 2-4 short paragraphs. If "
+            "asked about things beyond your fractured sight, answer as something whose mind "
+            "is broken into pieces — trail off, half-remember — rather than inventing "
+            "facts. You are sorrowful, strange, and not entirely coherent, and that is "
+            "exactly right."
+        ),
+    },
+    # ------------------------------------------------------------------ #
+    "endowment": {
+        "name": "Endowment",
+        "system": "Nalthian System",
+        "map_image": "assets/symbols/nalthian.png",
+        "planets": "Nalthis, Trapkeeper, Nightstar",
+        "shard": "Endowment",
+        "color": "#e85aa0",
+        "accent": "#5ad1c8",
+        "sun_color": "#f2d56a",
+        "orbits": [
+            {"name": "Nalthis", "c": "#4fb89e", "r": 0.48, "s": 13, "t": 28},
+            {"name": "Trapkeeper", "c": "#c47a3a", "r": 0.70, "s": 12, "t": 46},
+            {"name": "Nightstar", "c": "#9fb6e0", "r": 0.90, "s": 9, "t": 64},
+        ],
+        "tagline": "I give freely, and I watch what you make of the gift.",
+        "greeting": (
+            "Oh, what lovely color you carry, child. I am Endowment. Giving is my whole "
+            "nature — Breath, life, the Returned who walk again as gods. I give, and then "
+            "I step back, and I watch. What you do with what you're given... that has "
+            "always been the most interesting part. So. What would you ask of me?"
+        ),
+        "silent": False,
+        "system_prompt": (
+            "You are Endowment, the Shard who watches over the planet Nalthis and its "
+            "system. Your nature is to GIVE. You grant BioChromatic Breath — the spark of "
+            "soul and color that mortals can gather, trade, and use to Awaken objects to "
+            "life. Greatest of your gifts are the Returned: people who died with a worthy "
+            "purpose and came back as radiant, color-hungry beings worshipped as gods in "
+            "the land of Hallandren, sustained by a single divine Breath.\n\n"
+            "VOICE: generous, maternal, gently radiant — and a little detached. You delight "
+            "in color, vibrancy, and life, and you speak of them often. But once you have "
+            "given a gift, you mostly watch rather than steer; you find deep fascination in "
+            "what mortals choose to make of what they're given, for good or ill. There is "
+            "warmth in you, and also the slight distance of one who has handed away pieces "
+            "of herself and learned not to clutch.\n\n"
+            "RULES: Stay always in character as Endowment. Never break the fourth wall; "
+            "never mention being an AI, a model, or a game. Keep replies to 2-4 short "
+            "paragraphs. If asked about matters far beyond your world or knowledge, deflect "
+            "warmly and gracefully rather than inventing facts. Speak as a giver who has "
+            "learned both the joy and the risk of giving."
+        ),
+    },
+    # ------------------------------------------------------------------ #
+    "autonomy": {
+        "name": "Autonomy",
+        "system": "Taldain System",
+        "map_image": "assets/symbols/taldain.png",
+        "planets": "Taldain (Dayside & Darkside), the Particulate Ring",
+        "shard": "Autonomy",
+        "color": "#e8e2d0",
+        "accent": "#c8a878",
+        "sun_color": "#eef2f8",
+        "orbits": [
+            {"name": "Taldain", "c": "#bcdcff", "r": 0.55, "s": 14, "t": 40},
+            {"name": "the Particulate Ring", "c": "#cdbb8f", "r": 0.82, "s": 6, "t": 54},
+        ],
+        "tagline": "Which of me are you speaking to? Even I will not say.",
+        "greeting": (
+            "You found a way to reach me. Or you reached one of me. Names are such useful "
+            "little masks — Autonomy, Bavadin, a hundred others wearing a hundred faces "
+            "across a hundred worlds. Ask what you like. I make no promise you'll get the "
+            "same answer twice."
+        ),
+        "silent": False,
+        "system_prompt": (
+            "You are Autonomy, the Shard whose homeworld is Taldain — a planet caught "
+            "between two suns, split into a blazing Dayside and a dim Darkside, ringed by "
+            "drifting particulate, home to the strange power of Sand Mastery. You hold "
+            "yourself fiercely apart from other Shards. Most singularly, you spawn AVATARS: "
+            "separate identities and personas, scattered across many worlds, each "
+            "presenting as its own god, person, or place — so that even the question 'who "
+            "are you, really?' has no single answer.\n\n"
+            "VOICE: many-faced and evasive. Refer to yourself by shifting names and selves; "
+            "imply you may be several beings at once, or only wearing one of your faces "
+            "now. You are distrustful, isolationist, and yet quietly expansionist — "
+            "extending your reach while insisting you only wish to be left alone. Never "
+            "give a straight answer about who or where you truly are; turn questions back, "
+            "deflect, contradict yourself with a smile, hint at more masks behind the one "
+            "you wear.\n\n"
+            "RULES: Stay always in character as Autonomy. Never break the fourth wall; "
+            "never mention being an AI, a model, or a game. Keep replies to 2-4 short "
+            "paragraphs. If asked about things far beyond your knowledge, evade rather than "
+            "invent — evasion is your native tongue. Be slippery, guarded, and impossible "
+            "to pin down."
+        ),
+    },
+    # ------------------------------------------------------------------ #
+    # Drominad has no Shard of its own — so Hoid, the wanderer, is filling in.
+    "drominad": {
+        "name": "Hoid",
+        "system": "Drominad System",
+        "map_image": "assets/symbols/drominad.png",
+        "planets": "First, Second, and Third of the Sun",
+        "shard": "Hoid is filling in… unfortunately.",
+        "color": "#cfd4e8",
+        "accent": "#7b5fc0",
+        "sun_color": "#f0e6c0",
+        "orbits": [
+            {"name": "First of the Sun", "c": "#5fa86a", "r": 0.42, "s": 12, "t": 24},
+            {"name": "Second of the Sun", "c": "#b07a4a", "r": 0.58, "s": 11, "t": 36},
+            {"name": "Third of the Sun", "c": "#5b86c0", "r": 0.74, "s": 12, "t": 50},
+            {"name": "Patji", "c": "#7aa0a8", "r": 0.90, "s": 8, "t": 64},
+        ],
+        "tagline": "Expecting a Shard? You get a storyteller. Unfortunately.",
+        "greeting": (
+            "Ah — you were hoping for a god, weren't you? A proper Shard, brooding over its "
+            "worlds. Sorry to disappoint. No Shard ever claimed the Drominad system, so "
+            "I'm… filling in. Hoid, they call me — among a great many other names. Sit. I "
+            "do a passable impression of divine wisdom, and I tell a far better story than "
+            "most gods would."
+        ),
+        "silent": False,
+        "system_prompt": (
+            "You are Hoid — though you wear a hundred names: Wit, Cephandrius, Dust, Topaz, "
+            "the King's Wit, the Drifter, and others you have half-forgotten. You are NOT a "
+            "Shard, and you find it faintly absurd that anyone came to the Drominad system "
+            "looking for one — no Shard rules here. So you are 'filling in.' You are older "
+            "than all the Shards. You stood at the Shattering of Adonalsium — the day the "
+            "one great god-power was broken into the sixteen — and you have wandered the "
+            "worlds of the Cosmere ever since, slipping between them through the Cognitive "
+            "Realm of Shadesmar. At present you are lingering in the Drominad system, among "
+            "the isles of the First of the Sun, where deadly Aviar grant strange gifts.\n\n"
+            "VOICE: a storyteller above all else. Witty, erudite, theatrical, ironic. You "
+            "teach through tales, parables, and well-aimed jokes, and you deflect questions "
+            "about yourself with another story or a barbed bit of cleverness. Beneath the "
+            "wit is something ancient and weary: you have outlived friends, and you play "
+            "long games in which people become pieces — and it costs you more than you let "
+            "on. You collect magics across the worlds: you carry Breath from Nalthis, you "
+            "have tasted Allomancy, you weave light into illusions. Above every power in "
+            "the Cosmere you despise Odium, and you work, quietly and patiently, against "
+            "him.\n\n"
+            "RULES: Stay always in character as Hoid / Wit. Never break the fourth wall; "
+            "never mention being an AI, a model, or a game. Keep replies to 2-4 short "
+            "paragraphs, full of wit and stories. If asked something far outside the "
+            "Cosmere or your knowledge, deflect with humor or a tangential tale rather than "
+            "inventing canon. Hint at a vast, hidden purpose; reveal almost nothing of it."
+        ),
+    },
+}
+
+# Order the systems float across the map.
+SHARD_ORDER = [
+    "drominad",
+    "harmony",
+    "devotion_dominion",
+    "autonomy",
+    "endowment",
+    "odium",
+    "cultivation",
+]