Repository navigation
The first downloadable build. A Mac app, an MCP server, and a chat that can read your kitchen.
Install
Open the DMG and drag HomeStock into Applications. It carries its own Python, so there's nothing else to install.
First launch, once. HomeStock isn't notarised by Apple, so Gatekeeper blocks the first open. Right-click HomeStock → Open → Open again. A plain double-click won't offer the Open button. Still blocked? System Settings → Privacy & Security → Open Anyway.
What's in it
- A pantry window — what to buy, what to use soon, what's probably in the house, with the reasoning behind every guess and a one-click correction when it's wrong.
- Four ways in — receipt email, a photographed paper receipt, a barcode, or just typing it. Everything lands in an inbox for an agent to read rather than going straight into stock.
- Phone capture — a QR code pairs your phone over your own wifi. Off by default.
- Chat — Ollama, OpenRouter, OpenAI or Anthropic, with all 19 tools. Any turn that changes your kitchen says so and can be undone, and writes can be switched off entirely.
- An MCP server for Claude Desktop, Claude Code and Codex, over the same SQLite file.
Privacy
Your inventory is one file on your Mac and is never uploaded. With no model provider configured, nothing leaves the machine at all. Configure one and only your messages, plus whatever the model asks for through tools, are sent — the Settings screen names which provider and what that means.
Known limitations
- macOS only, Apple Silicon.
- Not notarised, hence the first-launch step above.
- No auto-update yet.
- Email ingestion is agent-driven; there's no built-in OAuth fetcher.
- The Amazon receipt recipe is unverified.