Skip to content

HomeStock 0.2.0

Latest

Choose a tag to compare

@Thomaspeel6 Thomaspeel6 released this 09 Nov 14:01
934120f

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.