From e40f95b8d7c5b498890ab590e337b5c980e224c9 Mon Sep 17 00:00:00 2001
From: Bryce <bryce@brycecovertoperations.com>
Date: Fri, 27 Mar 2026 08:59:18 -0700
Subject: [PATCH] Add README with usage instructions

- Quick start guide
- Feature list
- Usage workflow
- API reference
- Testing commands
---
 tools/ora_editor/README.md | 66 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 tools/ora_editor/README.md

diff --git a/tools/ora_editor/README.md b/tools/ora_editor/README.md
new file mode 100644
index 0000000..86817b3
--- /dev/null
+++ b/tools/ora_editor/README.md
@@ -0,0 +1,66 @@
+# ORA Editor - Browser-based OpenRaster Editor
+
+A web-based tool for editing ORA (OpenRaster) files with layer management, polygon drawing, and AI-powered mask extraction.
+
+## Quick Start
+
+```bash
+cd tools/ora_editor
+
+# Activate venv and install dependencies
+source ../venv/bin/activate  # or your Python environment
+pip install -r requirements.txt
+
+# Run the Flask server
+python app.py
+```
+
+The editor will be available at: http://localhost:5000
+
+## Features
+
+- **Open PNG/ORA files**: Enter file path relative to project root
+- **Layer management**: Toggle visibility, rename, delete, reorder layers  
+- **Polygon drawing**: Draw polygons to guide mask extraction
+- **Mask extraction**: Use ComfyUI to extract masks from images
+- **Krita integration**: Open layers in Krita for manual editing
+- **Settings**: Configure ComfyUI server URL
+
+## Usage Workflow
+
+1. **Open a file**: Enter path to PNG or ORA file (relative to `/home/noti/dev/ai-game-2`)
+2. **View layers**: See all layers with visibility checkboxes
+3. **Draw polygon** (optional): Describe the area you want separated
+4. **Extract mask**: Enter subject description and click "Extract Mask"
+5. **Review results**: See preview modal with extracted mask
+6. **Add to ORA**: Click "Use This Mask" to add as new layer
+7. **Edit in Krita** (optional): Select layer, open in Krita for manual work
+8. **Save**: Persist all changes
+
+## ComfyUI Setup
+
+- Default URL: `127.0.0.1:8188`
+- Configure via Settings gear icon
+- Workflow file must exist at `tools/image_mask_extraction.json`
+
+## API Endpoints
+
+| Endpoint | Method | Purpose |
+|----------|--------|---------|
+| `/api/open` | POST | Open PNG/ORA file |
+| `/api/save` | POST | Save current state |
+| `/api/layers` | GET | Get layer list |
+| `/api/layer/*` | POST | Layer operations (add, rename, delete, reorder) |
+| `/api/polygon` | POST | Draw polygon overlay |
+| `/api/mask/extract` | POST | Extract mask via ComfyUI |
+| `/api/krita/open` | POST | Open layer in Krita |
+
+## Testing
+
+```bash
+# Test ORA operations
+python test_ora_ops.py
+
+# Test Flask API
+python test_app.py
+```