pyr0ball
01aae2eec8
Recipe corpus (#108): - Add _MAIN_INGREDIENT_SIGNALS to tag_inferrer.py (Chicken/Beef/Pork/Fish/Pasta/ Vegetables/Eggs/Legumes/Grains/Cheese) — infers main:* tags from ingredient names - Update browser_domains.py main_ingredient categories to use main:* tag queries instead of raw food terms; recipe_browser_fts now has full 3.19M row coverage (was ~1.2K before backfill) Bug fixes: - Fix community posts response shape (#96): add total/page/page_size fields - Fix export endpoint arg types (#92) - Fix household invite store leak (#93) - Fix receipts endpoint issues - Fix saved_recipes endpoint - Add session endpoint (app/api/endpoints/session.py) Shopping list: - Add migration 033_shopping_list.sql - Add shopping schemas (app/models/schemas/shopping.py) - Add ShoppingView.vue, ShoppingItemRow.vue, shopping.ts store Frontend: - InventoryList, RecipesView, RecipeDetailPanel polish - App.vue routing updates for shopping view Docs: - Add user-facing docs under docs/ (getting-started, user-guide, reference) - Add screenshots
57 lines
2.3 KiB
Markdown
57 lines
2.3 KiB
Markdown
# Receipt OCR
|
||
|
||
|
||
|
||
Receipt OCR automatically extracts grocery line items from a photo of your receipt and adds them to your pantry after you approve. It's available on the Paid tier and BYOK-unlockable on Free.
|
||
|
||
## Upload a receipt
|
||
|
||
1. Click **Receipts** in the sidebar
|
||
2. Click **Upload receipt**
|
||
3. Take a photo or select an image from your device
|
||
|
||
Supported formats: JPEG, PNG, HEIC, WebP. Maximum file size: 10 MB.
|
||
|
||
## How OCR processing works
|
||
|
||
When a receipt is uploaded:
|
||
|
||
1. **OCR runs** — the LLM reads the receipt image and identifies line items, quantities, and prices
|
||
2. **Review screen** — you see each extracted item with its detected quantity
|
||
3. **Approve or edit** — correct any mistakes, remove items you don't want tracked
|
||
4. **Confirm** — approved items are added to your pantry in bulk
|
||
|
||
The whole flow is designed around human approval — Kiwi never silently adds items to your pantry. You always see what's being imported and can adjust before confirming.
|
||
|
||
## Reviewing extracted items
|
||
|
||
Each extracted line item shows:
|
||
|
||
- **Product name** — as extracted from the receipt
|
||
- **Quantity** — detected from the receipt text (e.g., "2 × Canned Tomatoes")
|
||
- **Confidence** — how certain the OCR is about this item
|
||
- **Edit** — correct the name or quantity inline
|
||
- **Remove** — exclude this item from the import
|
||
|
||
Low-confidence items are flagged with a yellow indicator. Review those carefully — store abbreviations and handwriting can trip up the extractor.
|
||
|
||
## Free tier behavior
|
||
|
||
On the Free tier without a BYOK backend configured:
|
||
|
||
- Receipts are stored and displayed
|
||
- OCR does **not** run automatically
|
||
- You can enter items from the receipt manually using the item list view
|
||
|
||
To enable automatic OCR on Free tier, configure a [BYOK LLM backend](../getting-started/llm-setup.md).
|
||
|
||
## Tips for better results
|
||
|
||
- **Flatten the receipt**: lay it on a flat surface rather than crumpling
|
||
- **Include the full receipt**: get all four edges in frame
|
||
- **Good lighting**: avoid glare on thermal paper
|
||
- **Fresh receipts**: faded thermal receipts (older than a few months) are harder to read
|
||
|
||
## Re-running OCR
|
||
|
||
If OCR produced poor results, you can trigger a re-run from the receipt detail view. Each re-run uses a fresh extraction — previous results are discarded.
|