← Directory

homebox-companion

AI companion for a Homebox inventory.

  • Productivity
  • Tools & Utilities
AI companion for a Homebox inventory. Photograph your things and let a vision model identify them, then create the items - including photos, quantities, manufacturer, model and tags - directly in Homebox. An AI chat helps to search, organise and update the inventory. REQUIREMENTS: a running Homebox server and an API key for an LLM provider (OpenAI, Anthropic, Google or OpenRouter via LiteLLM). The LLM key is paid per use; the project estimates roughly 0.30 USD per 100 items with gpt-5-mini. SETUP: set "Homebox URL" to the address of your Homebox server including its port, as reachable from inside this container - the server IP works, "localhost" does not. Keep the data folder mapped so settings, AI profiles and custom fields survive updates. LOGIN: by default the app asks for your Homebox username and password. Filling in the optional Homebox API key (Homebox 0.26.0 or newer, Profile -

Platform availability

Available on 1 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

63/100 Good

Maintained
91last commit 22 days ago
Popular
52396 GitHub stars
Easy to install
201 install platform, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
396
Open issues
18
Last commit
2026-09-21
Latest release
v3.1.1
License
GPL-3.0
Activity
rising

Checked today - source: GitHub (Duelion/homebox-companion)

Resources & Compatibility

Requirements not published yet.

Checked today - source: Docker Hub image tags and published docs

First-install notes

No first-install notes yet.

Alternatives

No alternatives collected yet.

Common questions

Which address should I use for the Homebox server in Homebox Companion?

Set the Homebox URL to the address of your Homebox server, including its port, as reachable from inside the companion container. The server IP works, while localhost does not.

How do I keep settings and custom fields from being lost during updates?

Keep the data folder mapped to the container. That preserves settings, AI profiles, and custom fields across updates.

Which LLM providers can I configure, and how is model usage billed?

It requires an API key for an LLM provider, with OpenAI, Anthropic, Google, or OpenRouter via LiteLLM listed. The key is paid per use, and the project estimates roughly 0.30 USD per 100 items with gpt-5-mini.

Can the AI chat update my Homebox inventory?

Yes, the AI Chat can organize, search, and update the inventory.

Answers sourced from github.com, github.com

Community

No community discussions collected yet.