Create README.md

README.md

@@ -0,0 +1,35 @@
+---
+title: Grid Cut Optimizer
+emoji: 🏘️
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: 4.19.2
+app_file: app.py
+pinned: false
+---
+
+# Grid Cut Optimizer for Victorian Developments
+
+An AI-powered tool for optimizing residential lot subdivisions in Victorian greenfield developments.
+
+## Features
+
+- **Automatic Optimization**: Uses genetic algorithms to find optimal lot configurations
+- **SLHC Grouping**: Groups narrow lots together for better streetscape (garages adjoining)
+- **Visual Before/After**: See exactly how AI improves your layout
+- **Instant Metrics**: Yield, efficiency, density calculations
+- **PSP Compliance**: Ensures 20+ dwellings/hectare targets
+
+## How to Use
+
+1. Enter your stage dimensions (width and depth)
+2. Select which lot types to include
+3. Optionally enter your current manual layout
+4. Click "Optimize with AI" to see results
+
+## Technical Details
+
+- Uses genetic algorithm (50 generations, 100 population)
+- Considers Victorian ResCode and Small Lot Housing Code
+- Optimizes for yield, streetscape quality, and SLHC grouping