🏠 homemgmt-ng
Plan your whole house in 3D – and every compartment of every piece of furniture becomes a storage location.
House planner, home inventory and shopping list in one self-hosted web app – on the PC, on your phone and on a wall-mounted tablet.
AI assistant · Features · Wall terminal · Live weather · A real house · Installation · Guide · Operation · Development
What is it?
Where are the batteries? Is there any dish soap left? What expires this week? homemgmt-ng answers these questions
by modeling your house: you draw floors, walls and rooms, place furniture in them – and every compartment and every
drawer automatically becomes a location with its own code (KU-C2 = kitchen, furniture C, compartment 2). You
check items in and take them out with a click, a QR scan, your voice or the AI assistant. The search "Where is …?"
lights up the matches in the house.
Everything runs on your own computer or server: one Node process, one SQLite file, no cloud.
The app is available in German and English. The language follows your browser and can be switched under More → Settings.
The AI assistant
Say, type or photograph what happened – the assistant books it into the right compartment.
- 📷 Photograph a shelf = inventory done: take a photo of the shelf or drawer, ideally with the compartment's QR
label in the picture. The assistant recognizes all items in the photo, creates new ones, increases existing ones
and checks everything into that compartment in one step – from four transactions on, only after you confirm. If you
like, it stores the photo with the item.
- 🎤 Just say it: "3 cans of tomatoes into the pantry cabinet, best before 05/2027" – it understands compartments
by name ("kitchen fridge top") and reads its answers aloud.
- 🔎 Ask and find: "Where is the cordless drill?", "What expires this week?" – with "Show in house".
- 🏷️ QR labels in photos are read by the app itself: "this goes here" is enough.
- 🛒 Shopping and prices: add to the list, tick off, "Where is butter cheapest right now?" (price research with
retailer, store and source).
- 🖥️ Talk to the wall terminal: press "Speak", tap your tile, go – limited to search, transactions and shopping there.
- ↩️ Safe: every transaction can be undone, the assistant acts with the person's permissions; works with any
OpenAI-compatible provider (OpenRouter, LiteLLM …), plus an MCP server for Claude & co. – details under
AI assistant and MCP server.
Features
🏗️ Plan your house
- Floors – ground floor, upper floor, basement, attic and outdoors, with the floor below as a drawing aid
- Walls with snapping and dimensions, doors, windows, stairs; upload a floor plan image and trace it
- Rooms with one click into an enclosed area – every room becomes a storage area with a code (kitchen →
KU)
- Furniture catalog: kitchen cabinets, shelf units, heavy-duty shelving, pantry and wardrobe, sideboard, chest of
drawers, workbench
- Object library: build your own furniture types in the editor (columns, drawers, doors with shelves, open
compartments – or your own 3D model with compartments) and install them from the community catalog
(homemgmt-object-library); every compartment becomes a location
- 3D models from Poly Haven (CC0) and FurniMesh – search and place them, or upload your own
.glb
- 3D view with PBR materials, daylight by time of day, photorealistic path tracing and walk-through like
in a game (including stairs between floors)
- House location: address or coordinates and north direction – the sun is where it is outside
📦 Inventory
- Check in, take out, move, undo with a complete history per item
- QR scan with the phone camera: compartment code + item = check in, the same item twice = take out
- Labels & QR signs to print – or as multicolour 3D print models (3MF)
- Shopping list: consumables land on it automatically when taken out, share via WhatsApp
- Household tasks: recurring, assigned to people, attached to compartments ("replace filter"), can be ticked off
on the wall terminal too
- Expiry with warnings, containers (a box inside the toolbox), photos per item
- Insights, export/import as Excel, automatic backups
- Offline-safe: transactions made on poor Wi-Fi are queued and synced automatically
📱 On your phone
- Installable as an app (PWA) with shortcuts; on the phone a bar at the bottom with Scan in the middle
- Overview as the home page: quick actions, shopping list to tick off, what expires soon, fill level per floor,
recently moved
- Poor Wi-Fi: transactions are queued ("2 transactions waiting") and synced automatically – the server never books twice
- Multiple people signing in with a tile + PIN/password or email, "Plan the house" permission per person
- Settings per person: home page, house in 2D or 3D first, light/dark, font size
🖥️ Wall terminal
A tablet on the wall becomes the control center for everyone in the house – without personal sign-in.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
