kiwi/docs/reference/tier-system.md
pyr0ball 01aae2eec8
Some checks failed
CI / Backend (Python) (push) Has been cancelled
CI / Frontend (Vue) (push) Has been cancelled
CI / Backend (Python) (pull_request) Has been cancelled
CI / Frontend (Vue) (pull_request) Has been cancelled
fix: recipe enrichment backfill, main_ingredient browser domain, bug batch
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
2026-04-18 15:38:56 -07:00

2 KiB

Tier System

Kiwi uses CircuitForge's standard four-tier model. The free tier covers the full pantry tracking workflow. AI features are gated behind Paid or BYOK.

Feature matrix

Feature Free Paid Premium
Inventory
Inventory CRUD
Barcode scan
Receipt upload
Expiry alerts
CSV export
Recipes
Recipe browser
Pantry match (L1)
Substitution (L2)
Style templates (L3) BYOK
Full generation (L4) BYOK
Leftover mode 5/day Unlimited Unlimited
Saved recipes
Save + notes + star rating
Style tags (manual)
LLM style auto-classifier BYOK
Named collections
Meal planning
OCR
Receipt OCR BYOK
Account
Multi-household

BYOK = Bring Your Own LLM backend. Configure a local or cloud inference endpoint and these features activate at any tier. See LLM Setup.

Pricing

Tier Monthly Lifetime
Free $0
Paid $8/mo $129
Premium $16/mo $249

Lifetime licenses are available at circuitforge.tech.

Self-hosting

Self-hosted Kiwi is free under the MIT license (inventory/pipeline) and BSL 1.1 (AI features, free for personal non-commercial use). You run it on your own hardware with your own LLM backend. No subscription required.

The cloud-managed instance at menagerie.circuitforge.tech/kiwi runs the same codebase and requires a CircuitForge account.

Free key

Claim a free Paid-tier key (30 days) at circuitforge.tech. No credit card required.