corrected the readme

README.md

@@ -1,3 +1,15 @@
+---
+title: Ad Generator Lite
+emoji: 🎨
+colorFrom: blue
+colorTo: purple
+sdk: docker
+sdk_version: "latest"
+app_file: main.py
+pinned: false
+---
+
+
 # Ad Generator Lite
 
 Generate high-converting ad creatives for Home Insurance and GLP-1 niches using psychological triggers and AI-powered image generation.
@@ -35,7 +47,20 @@ Required variables:
 
 Optional variables:
 - `MONGODB_URL`: MongoDB connection string (for database features)
-- R2 Storage credentials (for cloud image storage)
+- R2 Storage credentials (for cloud image storage):
+  - `R2_ENDPOINT`: Cloudflare R2 endpoint URL
+  - `R2_BUCKET_NAME`: R2 bucket name
+  - `R2_ACCESS_KEY`: R2 access key
+  - `R2_SECRET_KEY`: R2 secret key
+  - `R2_PUBLIC_DOMAIN`: Optional custom domain for public URLs
+
+Production & Storage Settings:
+- `ENVIRONMENT`: Set to `"production"` for production deployment (default: `"development"`)
+- `SAVE_IMAGES_LOCALLY`: Whether to save images locally (default: `true`)
+  - In production: Set to `false` to disable local storage completely
+  - In production: Set to `true` to save temporarily (will be auto-deleted after retention period)
+- `LOCAL_IMAGE_RETENTION_HOURS`: Hours to keep images locally before cleanup (default: `24`)
+  - Only applies when `ENVIRONMENT=production` and `SAVE_IMAGES_LOCALLY=true`
 
 ### Running Locally
 
@@ -96,6 +121,22 @@ The `huggingface.yml` file configures:
 - Port 8000 for the FastAPI app
 - Health check endpoint
 
+### Production Configuration
+
+For production deployments on Hugging Face Spaces, set these environment variables:
+
+```bash
+ENVIRONMENT=production
+SAVE_IMAGES_LOCALLY=true  # Set to false to disable local storage completely
+LOCAL_IMAGE_RETENTION_HOURS=24  # Images older than this will be auto-deleted
+```
+
+**Important Notes:**
+- In production with `SAVE_IMAGES_LOCALLY=true`: Images are saved temporarily and automatically cleaned up after the retention period
+- In production with `SAVE_IMAGES_LOCALLY=false`: Images are NOT saved locally (only uploaded to R2)
+- Automatic cleanup runs every hour in production
+- Use the `/admin/storage/stats` endpoint to monitor storage usage
+
 ### Accessing Your Deployed App
 
 Once deployed, your app will be available at:
@@ -131,6 +172,11 @@ https://your-username-ad-generator-lite.hf.space
 - `GET /db/ad/{ad_id}` - Get specific ad
 - `DELETE /db/ad/{ad_id}` - Delete ad (requires auth)
 
+### Admin (Storage Management)
+- `GET /admin/storage/stats` - Get storage statistics for locally saved images (requires auth)
+- `POST /admin/storage/cleanup` - Manually trigger image cleanup (requires auth)
+  - Query parameter: `dry_run=true` to preview what would be deleted
+
 ### Health
 - `GET /health` - Health check
 - `GET /` - API information