SPACES_README.md

# DR-Image-Magic on Hugging Face Spaces

This is a Gradio web interface for managing the Artistic Photo Transform project.

## Deployment Instructions

### Option 1: Deploy to Hugging Face Spaces

1. Go to [Hugging Face Spaces](https://huggingface.co/spaces)
2. Create a new Space:
   - Select **Gradio** as the SDK
   - Choose your username/organization
   - Name it: `DR-Image-Magic` (or your preferred name)
3. In the Space settings:
   - Clone this repository or upload these files
   - The Space will automatically detect `gradio_app.py` and `requirements.txt`
4. Your Space will automatically start running!

### Option 2: Run Locally

```bash
# Install dependencies
pip install -r requirements.txt

# Run the Gradio app
python gradio_app.py
```

Then open your browser to `http://localhost:7860`

## Features

The Gradio interface provides:

### 📋 Project Info Tab

- View project details
- Tech stack information
- Setup instructions

### ⚙️ Setup Tab

- Install dependencies with one click
- Push database schema

### 🚀 Development Tab

- Start development server
- Run type checking
- Format code automatically
- Execute test suite

### 📦 Production Tab

- Build optimized production bundle
- Deployment guidance

## Environment Variables

To use this on Hugging Face Spaces with actual functionality, you'll need to:

1. Set up environment variables in your Space settings:
   - `NODE_ENV`
   - Database credentials
   - AWS S3 credentials
   - API keys

2. Navigate to Space Settings → Variables and secrets

## Requirements

- Python 3.8+
- Node.js 18+ (for running pnpm commands)
- pnpm package manager

## Source Code

Full project source: https://github.com/DR-Studios/DR-Image-Magic

## Note

This is a management interface for the DR-Image-Magic project. It assumes:

- The project files are cloned/deployed
- Node.js and pnpm are installed on the Spaces environment
- Environment variables are properly configured

For actual image transformation features, you'll need to:

1. Set up AWS S3 credentials
2. Configure AI model access (Claude, etc.)
3. Set up database connection
4. Configure authentication