winebox 0.1.2__tar.gz → 0.1.4__tar.gz

{winebox-0.1.2 → winebox-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: winebox
-Version: 0.1.2
+Version: 0.1.4
 Summary: Wine Cellar Management Application with OCR label scanning
 Project-URL: Homepage, https://github.com/jdrumgoole/winebox
 Project-URL: Repository, https://github.com/jdrumgoole/winebox
@@ -22,6 +22,7 @@ Classifier: Topic :: Home Automation
 Requires-Python: >=3.11
 Requires-Dist: aiofiles>=23.0.0
 Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: anthropic>=0.40.0
 Requires-Dist: bcrypt<4.1.0,>=4.0.0
 Requires-Dist: fastapi>=0.109.0
 Requires-Dist: jinja2>=3.1.0
@@ -32,6 +33,7 @@ Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pytesseract>=0.3.10
 Requires-Dist: python-jose[cryptography]>=3.3.0
 Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: slowapi>=0.1.9
 Requires-Dist: sqlalchemy>=2.0.0
 Requires-Dist: uvicorn[standard]>=0.27.0
 Provides-Extra: dev
@@ -40,6 +42,8 @@ Requires-Dist: httpx>=0.26.0; extra == 'dev'
 Requires-Dist: invoke>=2.2.0; extra == 'dev'
 Requires-Dist: myst-parser>=2.0.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-playwright>=0.4.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.5.0; extra == 'dev'
 Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: sphinx>=7.0.0; extra == 'dev'
 Description-Content-Type: text/markdown
@@ -173,6 +177,38 @@ Images are served via the API at `/api/images/{filename}`.
 
 **Note:** The `data/` directory is excluded from git (see `.gitignore`). Make sure to back up this directory to preserve your wine collection data.
 
+## Label Scanning
+
+WineBox uses AI-powered label scanning to extract wine information from photos.
+
+### Claude Vision (Recommended)
+
+For best results, configure Claude Vision by setting your Anthropic API key:
+
+```bash
+export ANTHROPIC_API_KEY=your-api-key
+# or
+export WINEBOX_ANTHROPIC_API_KEY=your-api-key
+```
+
+Claude Vision provides intelligent label analysis that:
+- Handles decorative and artistic fonts
+- Understands wine-specific terminology
+- Extracts structured data (winery, vintage, grape variety, region, etc.)
+- Works with curved or angled text
+
+### Tesseract OCR (Fallback)
+
+If no Anthropic API key is configured, WineBox falls back to Tesseract OCR. This requires Tesseract to be installed on your system:
+
+```bash
+# macOS
+brew install tesseract
+
+# Ubuntu/Debian
+sudo apt-get install tesseract-ocr
+```
+
 ## Authentication
 
 WineBox requires authentication for all API endpoints (except `/health`).

{winebox-0.1.2 → winebox-0.1.4}/README.md

@@ -127,6 +127,38 @@ Images are served via the API at `/api/images/{filename}`.
 
 **Note:** The `data/` directory is excluded from git (see `.gitignore`). Make sure to back up this directory to preserve your wine collection data.
 
+## Label Scanning
+
+WineBox uses AI-powered label scanning to extract wine information from photos.
+
+### Claude Vision (Recommended)
+
+For best results, configure Claude Vision by setting your Anthropic API key:
+
+```bash
+export ANTHROPIC_API_KEY=your-api-key
+# or
+export WINEBOX_ANTHROPIC_API_KEY=your-api-key
+```
+
+Claude Vision provides intelligent label analysis that:
+- Handles decorative and artistic fonts
+- Understands wine-specific terminology
+- Extracts structured data (winery, vintage, grape variety, region, etc.)
+- Works with curved or angled text
+
+### Tesseract OCR (Fallback)
+
+If no Anthropic API key is configured, WineBox falls back to Tesseract OCR. This requires Tesseract to be installed on your system:
+
+```bash
+# macOS
+brew install tesseract
+
+# Ubuntu/Debian
+sudo apt-get install tesseract-ocr
+```
+
 ## Authentication
 
 WineBox requires authentication for all API endpoints (except `/health`).

{winebox-0.1.2 → winebox-0.1.4}/docs/index.md

@@ -6,7 +6,7 @@ Welcome to WineBox, a wine cellar management application with OCR label scanning
 
 WineBox helps you manage your wine collection by:
 
-- **Scanning wine labels** using OCR to automatically extract wine details
+- **Scanning wine labels** using Claude Vision AI (with Tesseract OCR fallback) to automatically extract wine details
 - **Tracking inventory** with check-in and check-out functionality
 - **Searching your cellar** by vintage, grape variety, region, and more
 - **Maintaining history** of all bottle movements
@@ -23,10 +23,14 @@ cd winebox
 # Install dependencies
 uv sync --all-extras
 
-# Install Tesseract OCR (macOS)
+# Set up Claude Vision (recommended for better label scanning)
+# Add your Anthropic API key to .env file:
+echo "WINEBOX_ANTHROPIC_API_KEY=your-api-key-here" > .env
+
+# Install Tesseract OCR as fallback (macOS)
 brew install tesseract
 
-# Install Tesseract OCR (Ubuntu/Debian)
+# Install Tesseract OCR as fallback (Ubuntu/Debian)
 sudo apt-get install tesseract-ocr
 ```
 
@@ -70,8 +74,8 @@ api-reference
 ### Check-In Process
 
 1. Upload front label image (required) and back label (optional)
-2. OCR automatically extracts text from the labels
-3. Wine parser identifies: vintage, winery, grape variety, region, country
+2. Claude Vision AI (or Tesseract OCR fallback) automatically analyzes the labels
+3. Form fields are instantly populated with: wine name, vintage, winery, grape variety, region, country, alcohol %
 4. Review and edit auto-detected values
 5. Specify quantity of bottles
 6. Wine is added to your cellar with a CHECK_IN transaction

{winebox-0.1.2 → winebox-0.1.4}/docs/user-guide.md

@@ -27,16 +27,25 @@ The check-in process adds bottles to your cellar inventory.
 2. **Upload the front label image** (required):
    - Click the file input or drag and drop an image
    - Supported formats: JPG, PNG, GIF, WebP
+   - Form fields are automatically populated as soon as the image is uploaded
 3. **Upload the back label image** (optional):
    - Back labels often contain additional details
+   - Scanning updates with information from both labels
 4. **Review auto-detected values**:
-   - The OCR system will attempt to extract wine details
-   - Edit any incorrect values
+   - Claude Vision AI (or Tesseract OCR fallback) extracts wine details
+   - A toast notification shows which scanning engine was used
+   - Edit any incorrect values as needed
+   - View raw label text in the collapsible "Raw Label Text" section
 5. **Set the quantity**:
    - Enter the number of bottles you're adding
 6. **Add notes** (optional):
    - Where you purchased it, price, occasion, etc.
 7. Click **Check In Wine**
+8. **Review in confirmation dialog**:
+   - A confirmation dialog appears with all editable fields
+   - Make any final adjustments to wine details
+   - View raw label text by expanding the "Raw Label Text" section
+   - Click **Confirm** to save or **Cancel** to return to the form
 
 ### Using the API
 
@@ -150,13 +159,15 @@ Shows the last 10 transactions with quick details.
 
 ### Taking Good Label Photos
 
-For best OCR results:
+For best scanning results with Claude Vision:
 
 1. **Good lighting**: Natural light or well-lit room
 2. **Flat surface**: Lay the bottle on its side or hold label flat
 3. **Focus**: Ensure text is sharp and readable
 4. **Full label**: Capture the entire label in frame
-5. **High resolution**: Higher resolution improves OCR accuracy
+5. **High resolution**: Higher resolution improves accuracy
+
+Claude Vision provides intelligent label analysis that understands wine label context. If the Anthropic API key is not configured, the app falls back to Tesseract OCR.
 
 ### Organizing Your Cellar
 
@@ -172,3 +183,56 @@ Your data is stored in:
 - **Images**: `data/images/`
 
 Back up these files regularly to preserve your cellar records.
+
+## Development
+
+### Running Tests
+
+WineBox has both unit tests and end-to-end (E2E) browser tests.
+
+```bash
+# Run all tests (unit + E2E)
+invoke test
+
+# Run only unit tests (fast, no server required)
+invoke test-unit
+
+# Run only E2E tests (requires running server)
+invoke test-e2e
+
+# Run E2E tests with more workers for faster execution
+invoke test-e2e --workers 8
+```
+
+**Note**: E2E tests use Playwright for browser automation and create unique test users for parallel execution. The server must be running (`invoke start-background`) before running E2E tests.
+
+### Invoke Tasks
+
+Common development tasks:
+
+```bash
+# Server management
+invoke start              # Start server in foreground
+invoke start-background   # Start server in background
+invoke stop               # Stop the server
+invoke restart            # Restart the server
+invoke status             # Check server status
+invoke logs               # View server logs
+
+# Database management
+invoke init-db            # Initialize database
+invoke purge --force      # Delete database and images
+invoke purge-wines --force # Delete wines but keep users
+
+# User management
+invoke add-user <username> --password <pass>
+invoke remove-user <username> --force
+invoke list-users
+invoke disable-user <username>
+invoke enable-user <username>
+invoke passwd <username> --password <newpass>
+
+# Documentation
+invoke docs-build         # Build Sphinx documentation
+invoke docs-serve         # Build and serve docs locally
+```

{winebox-0.1.2 → winebox-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "winebox"
-version = "0.1.2"
+version = "0.1.4"
 description = "Wine Cellar Management Application with OCR label scanning"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -36,6 +36,8 @@ dependencies = [
     "passlib>=1.7.4",
     "bcrypt>=4.0.0,<4.1.0",
     "python-jose[cryptography]>=3.3.0",
+    "anthropic>=0.40.0",
+    "slowapi>=0.1.9",
 ]
 
 [project.urls]
@@ -47,6 +49,8 @@ Issues = "https://github.com/jdrumgoole/winebox/issues"
 dev = [
     "pytest>=8.0.0",
     "pytest-asyncio>=0.23.0",
+    "pytest-playwright>=0.4.0",
+    "pytest-xdist>=3.5.0",
     "httpx>=0.26.0",
     "invoke>=2.2.0",
     "sphinx>=7.0.0",