README.md

metadata

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