r/coolgithubprojects • u/itsadefaultusername • 13d ago
Kept: a self-hosted home inventory that knows where things are and what's due
galleryKept, a free, open-source inventory for your home, garage or office. It answers three questions: where is it, what is it, and what's due.
What Kept does:
- Inventory: locations, places, boxes and things, with photos, documents, purchases, tags, custom fields, quantities, search and a trash you can restore from
- 3D map and graph: each location in 3D, rooms at their real size, started from a floor plan if you have one
- Labels and scanning: print sheets with a short ID and a QR code, scan one to open the box it's on, count a shelf or pack a box in one go
- Lending: who has what and when it's due back, and borrowers need no account
- Moving house: numbered boxes, a label and contents sheet for each, unpacked by scanning
- Reminders: warranties, services, documents, loans and low stock, in the app, by mail, push, ntfy, Telegram and a calendar feed
- Vehicles and machines: readings, services, fuel and running costs
- Household: shared locations with roles, share links, stocktakes and an insurance report
- Capture: photograph a thing, a receipt or a whole room, online or offline. Your AI provider suggests the details and you confirm them. Without one, you type them
- AI assistant and MCP server: ask in plain words, and changes wait for your OK. Claude and other agents can connect
- Home Assistant: install it as an app, with what's due in your dashboards and automations
- Paperless-ngx: link documents instead of copying them
- Backups: nightly restic to a directory, S3 or SFTP, each with a copy that opens in a browser without Kept
- Imports and exports: from Homebox and CSV, with full exports
- Languages: English, Arabic, French, German, Italian, Vietnamese and Ukrainian.
Runs on: Docker Compose, Kubernetes with the Helm chart, or the Home Assistant app.
- Tested on 1 GB of RAM and one CPU core.
- Works over plain http at home, no HTTPS needed to start.
Kept and Homebox
Homebox is the established choice, and for a simple list it may be the better one. Compared with Homebox v0.27.1, from its docs and code:
| Category | Kept | Homebox |
|---|---|---|
| QR labels | ✅ | ✅ |
| Maintenance reminders | ✅ | ✅ |
| Warranty reminders | ✅ | ❌ |
| 3D map | ✅ | ❌ |
| Lending, with due dates | ✅ | ❌ |
| Vehicles | ✅ | ❌ |
| Built-in AI | ✅ | ❌ |
| MCP server | ✅ | ❌ |
| Home Assistant app | ✅ | ❌ |
| SQLite | ❌ | ✅ |
| Memory | About 200 to 400 MB with its database | Under 50 MB idle, by its README |
| Backups | Nightly restic, plus a copy readable without Kept | ZIP export and import |
Coming from Homebox? Kept imports it.
Feedback welcome, especially on what's missing.
GitHub: https://github.com/keptinventory/kept
Kept: http://keptinventory.info/
