🏠 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

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.

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.

Inventory in the plan: tap a piece of furniture to see its compartments, a compartment to see its contents – check in, take out, move.	Inventory in 3D: compartments colored by fill level, expiry or activity (heatmap).
House planner: draw walls or trace a floor plan, furniture catalog, 3D models from online libraries.	"Where is …?": search across all storage areas, matches light up in the 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

• 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

Overview: quick actions, shopping, expiring items	Compartment as a bottom sheet

• 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

A tablet on the wall becomes the control center for everyone in the house – without personal sign-in.

Landscape: navigation on the left edge, weather and clock at the top	"Who is booking?"	Idle mode

• Setup: Administration → Wall terminals → Create wall terminal, then open the setup link or its QR code on the tablet – no password on the device. Regenerate the link or remove the terminal at any time.
• Configurable per device: portrait or landscape, house as floor plan or 3D, light/dark, font size up to "very large", minutes until it returns to the house, idle mode on/off, level of detail (draft 15 s, normal 30 s, high 90 s), postal code for the weather.
• Booking for everyone: tap a compartment, check in or take out, then tap your own "Who is booking?" tile; the person is remembered for 90 seconds. Large touch targets; only house, search, shopping and expiry – planning is locked.
• Idle mode: the house dimmed and photorealistic with lawn, a large clock, date, weather, shopping list and expiring items. Economical: re-renders only when the sun or weather changes, pauses when the screen is hidden.

Clear	Rain	Thunderstorm	Snow	Fog

With the house location (Plan → ⋯: address, postal code or coordinates, north direction via compass) the wall terminal shows the house as it looks outside – no account and no API key needed:

• Sun as outside: sun position from location and time; sky and light follow every minute – day, dusk, night with lamps switched on and moonlight. The floor plan shows a north arrow.
• Clouds according to real cloud cover, colored by time of day, drifting with the wind – in the photorealistic image too.
• Rain and drizzle as a subtle animation based on the real rain rate (mm/h), the lawn gets wet; fog and haze based on visibility; temperature and precipitation in the header.
• Snow grows as a patch: first on and in front of the terrace, from ~10 cm the whole garden; the roof goes from dusted to white.
• Thunderstorms in real time: every lightning strike nearby arrives instantly (Blitzortung.org, via server-sent events). Close strikes (≤ 30 km) make the screen flash, from 20 km the header shows a warning, and idle mode shows the last strike (distance, direction, age) and a lightning map (10/25/50 km).
• Test weather to try it out: open the terminal address with ?testwetter=schnee (snow; also schnee-hauch light snow, schneesturm blizzard, niesel drizzle, regen rain, wolkenbruch downpour, gewitter thunderstorm, nebel fog, wolkig cloudy, klar clear) – that is how the images above were made.

Data: location via OpenStreetMap, weather via Open-Meteo (every 15 minutes).

• Assistant in the app by text, voice or photo: "3 cans of tomatoes to basement B2, best before 05/2027" – books by itself, every transaction with "undo". Works with any OpenAI-compatible API (e.g. OpenRouter).
• MCP server for AI assistants like Claude: search, check in/take out, move, shopping list – authenticated with an API key

homemgmt-ng was built for a real single-family house – with basement, ground floor, upper floor, attic and outdoor area. These images show the plan of that house (taken with an earlier version of the interface).

Outside: gable roof, windows, carport and terrace – all floors stacked.	Ground floor: kitchen run with tall cabinets, cooking island, stairs and living area.
Upper floor: "Up to here" shows the floor with everything below it.	Kitchen: handleless fronts, a passage disguised as a cabinet, stone worktop.
Floor plan: traced over the scanned building plan, rooms as storage areas.	Basement: shelf units in the storeroom as locations, colored by fill level.

git clone https://github.com/mupf-dev/Homemgmt.git
cd Homemgmt
docker compose up -d --build

The app then runs at http://localhost:3000 (MCP server: port 3100). The data lives in the volume zuhause-data (/data in the container: zuhause.db, backups/, library/). Settings go into docker-compose.yml – the most important ones are already there, commented out.

Requires Node.js ≥ 22.18 (built-in node:sqlite; TypeScript runs on the server without a build step).

git clone https://github.com/mupf-dev/Homemgmt.git
cd Homemgmt
npm install
npm run build && npm start     # → http://localhost:3000

With an empty database the app shows the initial setup: tap "New person", choose a name and password – this person becomes admin. After that you sign in with a tile + password/PIN or with your email. Add more people under More → Administration → People; self-registration is off by default.

1. Open House → Plan (PC only). The floor tabs are at the top; + adds an upper floor, basement, attic or outdoor area.
2. Draw walls – or upload a scan/photo of the floor plan under Floor → Floor plan template, calibrate the scale and trace it. For simple rooms: Walls from dimensions.
3. Choose Define room and click into an enclosed area. Every room becomes a storage area with a code.
4. Place furniture from the catalog; cabinets snap to walls and neighbors (R rotates, Alt places freely). Every piece of furniture with compartments gets a letter, every compartment a location: KU-B2 (kitchen, furniture B, compartment 2).
5. Done – the plan is saved automatically and shared with everyone.

• View is the normal mode: tap a piece of furniture → compartments, tap a compartment → contents, Check in or − 1 to take one out.
• In 3D, Inventory colors compartments by fill level: blue empty, green occupied, orange expiring, red expired.
• "Where is …?" at the top searches all storage areas; matches light up in the floor plan and in 3D, floors with matches get a dot.
• On the phone: Scan in the middle of the bar. Scan the compartment code first, then the item = check in; the same item twice = take out. Unknown pre-printed labels create a new item.

More → Labels: labels for compartments, items or blank labels to stick on in advance (large 7 × 3.6 cm or small 5 × 2.5 cm). 3D signs (3MF) creates multicolour QR signs for 3D printing, laid out on print plates – entirely in the browser.

Mark items as consumables – when taken out they land on the shopping list. Tick them off there – or mark them as bought and check them straight back into their previous location. With a best-before date they show up in time under Expiring soon.

Administration → Wall terminals → Create wall terminal: choose portrait or landscape, then open the setup link (or its QR code) on the tablet. The terminal needs no personal sign-in; when booking it asks "Who is booking?". When not in use it switches to idle mode – with the house location (Plan → ⋯) including sun, sky and weather as outside. If there is lightning nearby, the terminal shows a warning and a lightning map. To try it out: open the address with ?testwetter=schnee (or regen, gewitter, nebel …).

Assistant: Administration → Assistant – enter the address of an OpenAI-compatible API (default https://openrouter.ai/api/v1), a model (with tool calling; with image input for photos) and an API key, then Test connection. The key stays on the server. Price research needs a web search: OpenRouter includes one; with a gateway like LiteLLM, enter its search tool under "Search tool in gateway".

MCP: create a key under Administration → API keys ("Read and book" or "Read only"), then e.g. in Claude Code:

claude mcp add --transport http zuhause http://localhost:3100/mcp --header "Authorization: Bearer hlk_…"

The complete manual for all inventory features is in docs/INVENTORY.md, the planner in docs/KITCHEN.md, background in ARCHITECTURE.md and what's new in the CHANGELOG.

More variables (e.g. MCP_ALLOWED_ORIGINS, PUBLIC_URL) are listed in docs/INVENTORY.md.

For permanent operation with HTTPS (Caddy, nginx, Traefik …) forward to the app on port 3000 and set TRUST_PROXY=1. Only expose the MCP server if you need it, and turn off buffering there (Caddy flush_interval -1, nginx proxy_buffering off). Details: docs/INVENTORY.md.

Backups are created automatically (every 24 h by default, 14 are kept) and can be created, downloaded and restored under Administration → Backups. To reset a password:

npm run reset-password -- anna                                             # without Docker
docker compose exec zuhause node scripts/reset-password.cjs anna           # with Docker

From the predecessor projects Heimlager and Küchenplaner (the sources are only read):

npm run migrate -- --lager ../inventory/data/lager.db --kueche ../küchenplaner/data/kuechenplaner.db

Accounts with the same email or the same name are merged into one person (otherwise --map mail@example.de=Name). In the app, the account menu entry "Import saved plans" brings a kitchen plan into the house as a floor. For the house floor plan of a running Heimlager instance there is npm run import-prod (see the header of scripts/import-prod.ts).

Copy a migrated database into the Docker container:

docker compose create
docker compose cp ./data/zuhause.db zuhause:/data/zuhause.db
docker compose cp ./data/library zuhause:/data/library
docker compose run --rm -u root --entrypoint chown zuhause -R node:node /data
docker compose up -d

npm run dev          # one process, app with Vite HMR → http://localhost:3000
npm test             # API tests, each with its own server and a fresh database
npm run typecheck    # app and server
npm run test:e2e     # click-through test in the browser (once: npm install --no-save playwright-core)

server/index.ts            Entry point: Express, modules, HTTPS, MCP
server/lager/              Inventory: account, storage areas, transactions, assistant, MCP, backups
server/haus/               House: saving the house plan, sync with the inventory
server/kueche/             Plans, user management, material library
web/app/src/model/         House model for app and server: types, catalog, geometry, rooms, compartments
web/app/src/               App: editor (plan2d), 3D (scene3d, models, materials), state, account
scripts/                   migrate, reset-password, make-cert, make-icons, import-prod
test/                      node:test, e2e/ click-through test in the browser
docs/                      Manuals and changelogs of the original projects
site/                      Project website (GitHub Pages) and screenshots

Tech: Express 5, built-in node:sqlite, TypeScript (server via type stripping without a build), Vite, three.js, three-gpu-pathtracer.

The remaining endpoints (storage areas, transactions, account, assistant, backups) are documented in docs/INVENTORY.md. API keys (Authorization: Bearer hlk_…) work for the REST API as well.

GNU Affero General Public License v3.0. You may use, modify and share homemgmt-ng. Anyone who distributes a modified version or offers it as an online service must publish the source code under the same license.

The house planner grew out of Küchenplaner 3D (kitchen planner, live demo).

Floor textures and 3D models from Poly Haven (CC0) · three.js · three-gpu-pathtracer · qrcode-generator (MIT) · jsQR (Apache-2.0) · location and weather via OpenStreetMap and Open-Meteo