neuman1812/nesventory repository overview

⁠NesVentory: Home Inventory Management System

NesVentory is a modern, self-hosted home inventory management application designed to help you track and organize household items, locations, warranties, and maintenance schedules. It features AI-powered item detection and enrichment to streamline the process of cataloging your home.

⁠🚀 Key Features

• AI-Powered Inventorying: Scan rooms with AI to detect items, extract product info from data tags, and automatically enhance item details.
• Media Management: Centralized dashboard for photos and videos, including metadata editing and location-specific media.
• Location & Hierarchy: Organize items by rooms and sub-locations with support for QR code labels and container/bin marking.
• Insurance Documentation: Dedicated insurance tab with policy management, automatic value calculation, and comprehensive report printing.
• Maintenance Tracking: Schedule recurring maintenance tasks and view them in a dedicated calendar.
• Multi-Property Support: Manage multiple homes, rental properties, and landlord/tenant information.
• Security & Access: Role-based access control (Admin, Editor, Viewer), Google OAuth SSO, and location-specific restrictions.
• Internationalized: Support for over 25 locales and 20+ currencies.

⁠🛠️ Tech Stack

• Backend: FastAPI (Python 3.11)
• Frontend: React + TypeScript + Vite (served by the backend)
• Database: SQLite (embedded, file-based)
• Deployment: Single unified Docker container

⁠📦 Quick Start with Docker

The easiest way to get started is using Docker Compose.

⁠1. Create a docker-compose.yml

services:
  nesventory:
    image: tokendad/nesventory:latest
    container_name: nesventory
    ports:
      - "8001:8001"
    volumes:
      - ./data:/app/backend/data
      - ./uploads:/app/backend/uploads
    environment:
      - SECRET_KEY=your_secure_random_key_here
      - GOOGLE_CLIENT_ID=your_google_id_here
      - GEMINI_API_KEY=your_api_key_here
    restart: unless-stopped