README.md

---
title: Elysium
emoji: 🌿
colorFrom: green
colorTo: indigo
sdk: gradio
sdk_version: 6.17.3
app_file: app.py
python_version: "3.12"
pinned: true
hardware: zero-a10g
short_description: Agentic Civilization with Bioluminescent Hypergraph
tags:
  - minicpm-v
  - voxcpm2
  - llama.cpp
  - agentic
  - track:wood
  - sponsor:modal
  - achievement:offbrand
  - achievement:llama
  - achievement:offgrid
  - achievement:welltuned
  - badge-tiny-titan
---

# 🌿 Elysium — Persistent Agentic Civilization

Elysium is a self-evolving civilization of agents living inside a fine-tuned MiniCPM-V 4.6 (≈4B).
Every interaction grows a Living Mycelial Hypergraph rendered as a bioluminescent, Google-Maps-style infinite canvas.

- **Brain:** fine-tuned MiniCPM-V 4.6 via `llama-cpp-python` on ZeroGPU
  - Repo: [`build-small-hackathon/elysium-MiniCPM-V-4.6-F16-GGUF`](https://huggingface.co/build-small-hackathon/elysium-MiniCPM-V-4.6-F16-GGUF)
  - File: `elysium-f16.gguf`
- **Voice:** VoxCPM2 (agent debate audio drama)
- **Memory:** `rustworkx` hypergraph persisted to `/data`
- **JSON:** GBNF grammar enforces a strict ElysiumResponse schema on every forward pass
- **Tools:** offline-first DuckDuckGo, email, reminders, calendar, weather, calculator, fetch_url, transit_lookup, files
- **Frontend:** 100% custom HTML/Canvas2D on `gradio.Server` (no default Gradio UI)

Runs identically online (HF Spaces) and offline (`git clone … && python app.py`).

## Required environment variables (Settings → Variables and secrets)

| Variable | Value |
|---|---|
| `ELYSIUM_MODEL_REPO` | `build-small-hackathon/elysium-MiniCPM-V-4.6-F16-GGUF` |
| `ELYSIUM_GGUF_FILE` | `elysium-f16.gguf` |
| `ELYSIUM_MMPROJ_FILE` | *(leave empty — no mmproj published yet, vision auto-disables)* |
| `HF_TOKEN` | your read token (optional for public repos but recommended) |

> The defaults already point at the real published repo, so you don't strictly need to set these — but doing so makes the Space's config explicit.