Rhea

Turn a folder of scanned grocery receipts into a clean, queryable dataset.

Releases · macOS 14+ · runs fully local

In development. Rhea is a personal tool under active development and has known bugs. Expect rough edges, and don't rely on it as your only copy of receipt data.

Drop in receipt PDFs, review each extraction next to the original scan, confirm it, and export to CSV or Postgres. Extraction runs against your own local vision model (LM Studio, oMLX, or anything else that speaks the OpenAI chat-completions API) — nothing leaves your machine.

Install#

Grab the latest .dmg from Releases, open it, drag Rhea to Applications.

Build from source#

Rhea is a native Xcode macOS App project generated by XcodeGen from project.yml (the source of truth — Rhea.xcodeproj itself isn't committed).

brew install xcodegen
xcodegen generate
open Rhea.xcodeproj

Then hit Run in Xcode, or build/run from the command line:

xcodebuild -project Rhea.xcodeproj -scheme Rhea -configuration Debug -derivedDataPath build build
open build/Build/Products/Debug/Rhea.app

See AGENTS.md for architecture and internals.

Run tests#

xcodegen generate
xcodebuild -project Rhea.xcodeproj -scheme Rhea -destination 'platform=macOS' test

This runs both RheaTests (unit, Swift Testing) and RheaUITests (XCUITest) headlessly.

_{Built with Claude Code.}