Run Lumo Proton's Private AI Inside Home Assistant

Share your Projects!
, ,
1

I love Proton's Lumo. It is a fantastic privacy-first AI assistant, but it is still locked behind the web interface. For people like me who want to integrate AI into their automations without compromising privacy or sending data to third-party clouds, there isn't a real solution, apart from running local LLMs on devices like the RPi5 or, if lucky, on a more powerful machine.

The community project lumo-tamer by ZeroTricks solved this by creating a local proxy that exposes Lumo's capabilities via an OpenAI-compatible API. And Home Assistant definitely understand the OpenAI API.

While lumo-tamer is powerful, setting it up in a Home Assistant environment can require some manual configuration and Docker knowledge. To make this easily accessible, I developed ha_app-lumo-tamer.

This is a dedicated Home Assistant app that packages lumo-tamer for almost seamless integration. Generating the initial token is still a bit cumbersome, but maybe some of you can help improve that workflow!

Key Features of the Add-on

  • Native Integration: Runs directly within Home Assistant as a standard add-on. No external Docker containers or complex networking required.
  • OpenAI Compatibility: Exposes a local endpoint using the Extended OpenAI Conversation integration that works seamlessly with Home Assistant's existing conversation tools.
  • Privacy First: All communication stays within your local network. Your prompts never leave your infrastructure, and authentication tokens are encrypted.
  • Easy Setup: Includes a guided configuration process and documentation for copying necessary vault files.
  • Built with Lumo: I actually wrote the code for this add-on using OpenCode connected to Lumo via the upstream project (I then contributed a guide on how to use lumo-tamer with OpenCode, proving the tool's utility for development workflows.

My First Agent: a calendar and agenda manager

I am now using it daily to keep my schedule organized:

  1. When I receive an email that requires an action, I forward it to myself into a dedicated IMAP folder.
  2. Home Assistant detects the new email.
  3. It sends the text to the ha_app-lumo-tamer endpoint.
  4. Lumo semantically analyzes the text, identifies it as a meeting or a task, and extracts the date/time.
  5. Home Assistant automatically creates the event in my Nextcloud calendar or adds the item to my to-do list.

This is just one example. I also added a voice assistant integration and I'm currently working on a morning "todo summary" greeting routine.

Get Started

You can find the add-on, installation instructions, and the token renewal automation blueprint here: ha_app-lumo-tamer on Codeberg

Huge thanks to ZeroTricks for creating the upstream lumo-tamer project that made this possible. If you have ideas for improving the token generation flow or other automations, feel free to open an issue or join the discussion!

2

Update: v0.6.0 is out — Lumo 2.0 support is here!
Proton launched Lumo 2.0 last month (Lite and Max models + a new thinking mode), and the add-on now supports all of it thanks to lumo-tamer.

What’s new in v0.6.0:

  • Model tiers: The server now advertises three models on /v1/models: lumo (Proton auto-routes), lumo-lite (fast, everyday tasks), and lumo-max (high-performance reasoning). Pick the tier with the standard OpenAI model field, or set a Default Model Tier in the add-on config for requests that omit it.
  • Thinking mode: Clients can enable Lumo’s reasoning with reasoning_effort. There’s also an option to forward Lumo’s thinking tokens back to Home Assistant as reasoning_content, if you want to surface the reasoning trace.
  • Token auto-refresh: Proton tokens expire every 24h. The add-on can now renew them automatically (enabled by default, 20h interval). No more daily manual renewal or scheduled automations required. You can still trigger /v1/auth/refresh manually if you prefer.
  • Stays alive on errors: If auth is missing or the server hits a token error, the add-on no longer stops: it logs the error and keeps running so you can open a terminal in the container and run tamer auth login directly. Much friendlier for first-time setup and no need for samba or ssh or scp.

The build is now pinned to the upstream lumo-tamer v0.6.0 release (the Lumo 2.0 work was merged upstream, so we’re no longer tracking a PR branch).

Update from the add-on store, or pull the latest from the repo. Existing configs carry over the new options, so nothing breaks on upgrade.

As before, the token generation workflow is still the clunky part — if anyone has ideas for smoothing that out, contributions welcome!

3

Thanks I’ll try it out!

Would love if this could expose a web gui to run the auth (looks like its supported by lumo-tamer ( # Optional: Browser service)and also if you could install and keep the add-on updated via hacs (If I understand correctly that we need the add-on installed permanently)

4

Hello, can i get help setting up Lumo 2.0

Thanks

5

when you install the add-on you are interacting with Lumo 2.0 already.