Update README.md

README.md

@@ -4,11 +4,76 @@ emoji: 📉
 colorFrom: red
 colorTo: indigo
 sdk: gradio
-sdk_version: 6.20.0
+sdk_version: 6.22.0
 python_version: '3.12'
 app_file: app.py
 pinned: false
 short_description: AI Image Enhancer and Outpainter
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# CanvasAI
+
+Three AI image tools in one interface — upscale and sharpen any photo, colorize black and white images automatically, or extend a scene beyond its original borders.
+
+---
+
+## Tools
+
+### ✨ Enhancement
+Real-ESRGAN upscales images 2× or 4×, reconstructing fine detail rather than stretching pixels. Processes large images in tiles to stay within VRAM limits.
+
+### 🎨 Colorization
+DDColor adds natural color to black and white images without changing structure or composition. Post-processed with LAB color space smoothing to reduce color patchiness, and a saturation boost to compensate for DDColor's tendency to under-saturate. Fully automatic — no prompt needed.
+
+### 🔲 Outpainting
+Extends your image in any direction using Stable Diffusion 2 Inpainting. BLIP reads the image and generates an appropriate prompt automatically. Uses a multi-pass 64px incremental approach with feathered mask blending for coherent results.
+
+---
+
+## How the Outpainting Works
+
+The pipeline extends 64 pixels at a time rather than all at once. Each small pass gives SD 87%+ original image context — SD extrapolates naturally from what it can see. One large extension gives SD only 60-70% context, and the generated content becomes incoherent.
+
+The mask uses GaussianBlur feathering so the boundary between original and generated content is a soft gradient rather than a hard cut. The mask is resized with LANCZOS (not NEAREST) to preserve this gradient when scaling to SD's 768×768 input size.
+
+---
+
+## Honest Limitations
+
+**Enhancement** does not deblur. It upscales and sharpens existing detail. Blurry input produces larger blurry output.
+
+**Colorization** works well on portraits, street scenes, and landscapes. Complex fabric patterns and heavily degraded photographs may produce inconsistent colors. Results will not match commercial colorization tools.
+
+**Outpainting** quality varies by input. Works best on simple consistent backgrounds at 25% extension or below. Struggles with complex foreground subjects near edges and high extension percentages. The multi-pass approach significantly improves over single-pass but does not eliminate the underlying model's limitations.
+
+---
+
+## Tips for Best Results
+
+- Enhancement: works on any image, best on photographs with existing sharp detail
+- Colorization: portraits and outdoor scenes colorize most consistently
+- Outpainting: use Horizontal or Vertical (not Both), keep extension at 25%, use the custom prompt field if BLIP misreads your image
+
+---
+
+## Models Used
+
+| Model | Purpose |
+|---|---|
+| RealESRGAN_x4plus | Super resolution |
+| stable-diffusion-2-inpainting | Scene extension |
+| blip-image-captioning-base | Auto prompt generation |
+| cv_ddcolor_image-colorization | B&W colorization |
+
+---
+
+## Privacy
+
+Images are processed in memory and not stored permanently. Uploaded images are deleted when your session ends. Do not upload sensitive or private images.
+
+---
+
+## GitHub
+
+Full code, architecture notes, and documentation:
+[github.com/yourusername/CanvasAI](https://github.com/yourusername/CanvasAI)