---
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