Skip to content

zedarvates/gardemanger

Repository files navigation

GardeManger 🥫🌱

Python License Status Food

Open-Source Food Autonomy System — Version 5.0

Zero-dependency Python REST API for food stock management, production tracking, nutrition planning, and emergency preparedness. Runs on any Linux box with Python 3.11+ — no Docker, no pip dependencies, no cloud.

Philosophy

  • Stdlib-onlyhttp.server + sqlite3 (WAL mode). No FastAPI, no Flask, no requests.
  • Flat architecture — route → handler → DB. No layers, no ORM, no middleware.
  • Data-oriented — batch processing, struct-of-arrays patterns.
  • Local-first — runs on your LAN. HA integration via REST sensor.
  • Resilient — WAL mode, auto-init, silent logging.

Modules

Module Status Description
📦 Stock Food stock tracking with expiry and low-stock alerts
🌱 Garden Garden bed planning, planting calendar, harvest tracking
🐔 Animals Animal inventory and production tracking (eggs, milk)
🌿 Spirulina Spirulina culture monitoring and harvest cycles
🍄 Mushroom Mushroom substrate management and yield tracking
💧 Water Water storage and consumption tracking
🥗 Nutrition Personal nutrition planning and macro tracking
⚠️ Emergency Emergency preparedness checklist and supply status
🔄 Recipes Ingredient → finished product transformation tracking
📊 Yields Production analytics and calendar forecasting

API

# Stock management
curl http://localhost:8771/api/stats
curl http://localhost:8771/api/produits
curl http://localhost:8771/api/produits/alerte
curl http://localhost:8771/api/produits/perime

# Production tracking
curl http://localhost:8771/api/plantations
curl http://localhost:8771/api/recoltes
curl http://localhost:8771/api/recettes
curl http://localhost:8771/api/productions
curl http://localhost:8771/api/calendrier
curl http://localhost:8771/api/yields

Quick Start

python3 gardemanger_v5.py
# 🥫 GardeManger v5.0 — stdlib only
#    Port: 8771
#    DB: ~/gardemanger.db (WAL mode)

Home Assistant Integration

Add ha_config.yaml to your Home Assistant configuration.yaml to get stock sensors on your dashboard.

Hermes Integration

GardeManger has a dedicated Hermes skill (gardemanger-producer) that provides:

  • Seasonal planting suggestions
  • Recipe recommendations from available stock
  • Harvest alerts and production analytics
  • Weekly production calendar briefing

Related Projects

License

MIT


Donate

About

GardeManger 3.0 — Open‑Source Food Autonomy System A complete self‑sufficiency management platform that helps you store food, grow your own resources, produce proteins, manage water, cultivate mushrooms, track nutrition, and prepare for emergencies. Includes 16 integrated modules covering stock management, gardening, animals, spirulina, mushroom

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors

Languages