<div align="center"> <img src="frontend/static/web-app-manifest-512x512.png" alt="llumen Logo" width="200" height="auto" />

Llumen

</div> <div align="center">

</div>

---

Why Llumen?

Most self-hosted interfaces are built for servers, not devices. They're powerful but demand heavy resources and hours of configuration.

Llumen carves out a different space: privacy without the complexity. You get the features you actually need, optimized for modest hardware: Raspberry Pi/old laptops/minimal VPS while keeping many features of commercial products.

| | Privacy | Power | Setup | | :--- | :--- | :--- | :--- | | Commercial (ChatGPT) | ❌ Cloud-only | ✅ High | ✅ Zero-config | | Typical Self-Host (Open WebUI) | ✅ Local | ✅ High | ❌ Config hell | | llumen | ✅ Local | ⚖️ Just enough | ✅ Zero-config |

Features

| Feature | What You Get | | :--- | :--- | | Speed | Sub-second cold starts, real-time token streaming | | Chat Modes | Normal, Web Search, & Deep Research with autonomous agents | | Rich Media | PDF uploads, LaTeX rendering, image generation | | Universal API | Any OpenAI-compatible provider (OpenRouter, local models, etc.) | | Minimal Footprint | ~17MB binary, <128MB RAM usage |

Quickstart

Default Login: admin / P@88w0rd

Docker (30-second setup)

docker run -it --rm \
  -e API_KEY="<YOUR_OPENROUTER_KEY>" \
  -p 80:80 \
  -v "$(pwd)/data:/data" \
  ghcr.io/pinkfuwa/llumen:latest

That's it. No config files. No Python dependencies.

Want bleeding edge? Use ghcr.io/pinkfuwa/llumen:nightly

See docker sample for docker-compose examples.

Native Binaries

Download from Releases for Windows/Linux, including arm build.

Building from Source

See BUILD.md for detailed build instructions.

Configuration (Optional)

| Variable | Description | Default | | :--- | :--- | :--- | | API_KEY | OpenRouter/provider key | required | | API_BASE | Custom endpoint | https://openrouter.ai/api | | DATA_PATH | Storage directory | . | | BIND_ADDR | Network Socket | 0.0.0.0:80 |

Documentation

https://pinkfuwa.github.io/llumen/

<div align="center"> Built with :heart: by pinkfuwa. Keep it simple, keep it fast. </div>