PINOKIO_GUIDE.md

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 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.