# Pinokio Deployment Guide for PortraitPerfectAI

This guide explains how to deploy the AI-Powered Facial & Body Feature Editor application using Pinokio for local hosting.

## What is Pinokio?

Pinokio is a browser-based platform that allows you to install, run, and manage AI applications locally on your computer. It provides a simple interface for installing and launching applications without dealing with complex command-line operations.

## Prerequisites

- [Pinokio](https://pinokio.computer/) installed on your computer
- A computer with sufficient resources to run AI applications:
  - At least 8GB RAM (16GB recommended)
  - At least 10GB free disk space
  - NVIDIA GPU with CUDA support (optional but recommended for better performance)

## Installation Steps

1. **Download the PortraitPerfectAI Pinokio Package**
   - Extract the ZIP file to a location of your choice

2. **Open Pinokio Browser**
   - Launch the Pinokio application on your computer

3. **Add the Application to Pinokio**
   - In Pinokio, click on the "+" button to add a new application
   - Navigate to the folder where you extracted the PortraitPerfectAI files
   - Select the folder and click "Open"

4. **Install the Application**
   - Once added, you'll see "PortraitPerfectAI" in your Pinokio dashboard
   - Click on the application
   - Click the "Install" button
   - Wait for the installation to complete (this may take several minutes as it installs Python dependencies)

5. **Launch the Application**
   - After installation is complete, click the "Launch" button
   - The application will start and open in your default web browser

## Using the Application

Once launched, you can:
- Upload images for editing
- Select facial and body features to modify
- Adjust settings using sliders and dropdowns
- Apply AI-powered edits to your images
- Download the edited results

## Troubleshooting

If you encounter any issues:

1. **Installation Fails**
   - Ensure you have a stable internet connection
   - Check that you have sufficient disk space
   - Try restarting Pinokio and attempting installation again

2. **Application Won't Launch**
   - Check the Pinokio logs for any error messages
   - Ensure Python is properly installed on your system
   - Try reinstalling the application

3. **Slow Performance**
   - If you don't have a GPU, processing will be slower
   - Try reducing the image size before uploading
   - Adjust the processing parameters to lower values

## Technical Details

The Pinokio package includes:
- `install.json` - Defines the installation process
- `run.json` - Defines how to run the application
- `pinokio.js` - Contains metadata and menu configuration
- `app.py` - The main application file
- Supporting modules in the `models/` and `utils/` directories

The application uses a Python virtual environment to isolate dependencies and ensure compatibility across different systems.