fork of arthurooo38/lists
  • Dart 54.4%
  • Python 32.7%
  • CMake 7.1%
  • C++ 4.6%
  • C 0.6%
  • Other 0.5%
Find a file
2026-06-29 20:28:53 +02:00
backend Add intent router, fridge scan & consumption tracking; restyle persona 2026-06-15 17:40:02 +02:00
mobile Bump version to 1.6.1+12 2026-06-29 20:28:53 +02:00
.env.example Complete implementation: Backend API, Telegram Bot, AI Integration, and Mobile App features 2026-06-11 01:28:38 +02:00
.gitignore Add bot slash-commands + pantry-aware recipe mode; migrate to google-genai SDK 2026-06-11 19:01:28 +02:00
docker-compose.yml Switch API to a more unique port: 8273 2026-06-11 02:11:18 +02:00
README.md Complete implementation: Backend API, Telegram Bot, AI Integration, and Mobile App features 2026-06-11 01:28:38 +02:00

AI Pantry & Shopping List Tracker

A personal system to track your pantry inventory and shopping list using AI and Telegram.

Components

  • Backend: FastAPI + PostgreSQL + Telegram Bot (running on Raspberry Pi).
  • Mobile App: Modified Flutter app for Android.
  • AI: Gemini API (primary) or Ollama (fallback).

Setup

  1. Backend:
    • Install Docker/Podman and Docker Compose.
    • Copy .env.example to .env and fill in your keys.
    • Run podman-compose up -d (or docker-compose).
  2. Mobile App:
    • Requires Flutter SDK.
    • Build the APK: cd mobile && flutter build apk.
    • Install on your phone.
    • In Settings, set the API URL to your Raspberry Pi's Tailscale IP.

Features

  • Message the bot to add items.
  • Send a photo of your fridge to analyze stock.
  • Send a receipt photo to automatically update inventory and track prices.
  • Ask the bot what you need for a recipe.
  • View stats and pantry in the app.