NeuroKitchen 2.0 is a minimalist, AI-augmented frontend for Grocy — bringing natural-language interaction to household management through the Hermes AI agent.
Five integrated modules covering every aspect of household food management, unified under a single clean interface.
Manage multiple lists simultaneously. Search products, check off items on the go, and keep every list synchronized with your Grocy instance.
Grocy SyncTrack stock levels, expiry dates, and low-stock warnings across your pantry. Never run out of essentials or let food expire unnoticed.
Expiry TrackingBrowse your recipe collection with adjustable serving counts. Ingredient availability is checked live against your current inventory.
Dynamic ScalingA weekly calendar view lets you drag and assign recipes to each meal slot. Plan the week ahead with what's actually available.
Weekly ViewChat with a Hermes AI agent that has full awareness of your Grocy data. Streaming responses, full conversation history, and natural-language queries.
Hermes AIConfigure your Grocy instance, Hermes endpoint, and preferences directly from the interface — no config-file editing required.
Zero ConfigA three-stage Docker build keeps credentials server-side and resolves CORS for cross-domain deployments.
Requires Docker, a Grocy instance, and a Hermes agent with an OpenAI-compatible API.
Get the source code from GitHub and enter the project directory.
git clone \
.../neurokitchen-2.0
Copy the example env file and fill in your Grocy URL, API key, and Hermes endpoint.
cp .env.example .env
Build the multi-stage Docker image and start the container in detached mode.
docker compose up -d \
--build
Navigate to your configured port. Add your first user via the SQLite CLI inside the container.
http://localhost:3000
The AI assistant connects to your live Grocy data and answers questions, suggests meals, tracks what's running low — all in plain conversation.
Conversation history is persisted in SQLite and replayed as context on each message, so the assistant remembers your session.