ubuntu-post-install/vendor/paintplus/docs/MODEL_SELECTION_GUIDE.md

Model Selection Guide for Body Parts and Editing Tasks

Quick Reference: Best Models by Use Case

Human Features (Faces, Hands, Bodies)

Best Choice: realistic-vision (Replicate)

AI_PROVIDER=replicate
REPLICATE_API_KEY=your-key
REPLICATE_MODEL=realistic-vision

Why: Trained specifically on human anatomy and realistic photos. Handles difficult features like:

• ✅ Hands (notoriously hard for AI)
• ✅ Faces and facial features
• ✅ Skin textures and tones
• ✅ Body proportions
• ✅ Portraits

Examples:

• "Fix the hand position"
• "Remove red eye"
• "Smooth skin blemishes"
• "Adjust facial expression"
• "Fix fingers"

Cost: ~$0.020/image Quality: ⭐⭐⭐⭐⭐

---

Object Removal

Best Choice: lama (Replicate)

AI_PROVIDER=replicate
REPLICATE_MODEL=lama

Why: Specifically designed for inpainting and object removal. Excellent at:

• ✅ Removing objects cleanly
• ✅ Filling in backgrounds naturally
• ✅ Maintaining surrounding context
• ✅ Fast and cheap

Examples:

• "Remove the person"
• "Delete the watermark"
• "Erase the object"
• "Clean up the background"

Cost: ~$0.002/image (cheapest!) Quality: ⭐⭐⭐⭐

---

General Purpose Editing

Best Choice: sdxl-inpaint (Replicate or Stability AI)

# Option 1: Replicate
AI_PROVIDER=replicate
REPLICATE_MODEL=sdxl-inpaint

# Option 2: Stability AI Direct
AI_PROVIDER=stability
STABILITY_MODEL=sdxl

Why: SDXL (Stable Diffusion XL) is the best all-around model for:

• ✅ Landscapes and scenery
• ✅ Objects and textures
• ✅ Creative edits
• ✅ Style changes
• ✅ Adding elements

Examples:

• "Change sky to sunset"
• "Add flowers"
• "Make it autumn"
• "Replace with grass"

Cost:

• Replicate: ~$0.025/image
• Stability AI: ~$0.040/image

Quality: ⭐⭐⭐⭐⭐

---

Detailed Comparison by Body Part

Hands ✋

Challenge: Hands are the hardest thing for AI to generate correctly. Common issues:

• Wrong number of fingers
• Unnatural finger positions
• Distorted proportions
• Weird joints

Best Models (in order):

1. Realistic Vision (Replicate) - ⭐⭐⭐⭐⭐

   • Best overall for hands
   • Understands hand anatomy
   • Cost: ~$0.020/image

2. SDXL Inpainting (Replicate/Stability) - ⭐⭐⭐

   • Decent but less consistent
   • Cost: ~$0.025-0.040/image

3. DALL-E 2 (OpenAI) - ⭐⭐

   • Often struggles with hands
   • Not recommended

Tips for Better Hand Edits:

• Use detailed prompts: "realistic human hand with five fingers"
• Add negative prompts if provider supports: "deformed, extra fingers, missing fingers"
• Use Mode B (full image context) for better results
• Consider editing in multiple passes if needed

---

Faces 😊

Challenge: Faces need to look natural and maintain proper proportions

Best Models:

1. Realistic Vision (Replicate) - ⭐⭐⭐⭐⭐

   • Excellent for facial features
   • Natural skin textures
   • Good expression handling

2. SDXL Inpainting - ⭐⭐⭐⭐

   • Good for general facial edits
   • Better for style than realism

Use Cases:

• Remove blemishes
• Fix red eye
• Adjust expressions
• Change hair
• Smooth wrinkles

---

Full Body / Torso 🧍

Best Model: Realistic Vision

Why: Maintains body proportions and realistic anatomy

Examples:

• "Fix the clothing wrinkles"
• "Change shirt color to blue"
• "Remove the stain"

---

Hearts ♥️ (Decorative Elements)

Best Model: SDXL Inpainting

Why: Great for creative and decorative elements

Examples:

• "Add heart shape"
• "Draw a heart pattern"
• "Replace with hearts"

---

Auto-Selection Feature

The system automatically selects the best model based on your prompt:

Keywords that trigger realistic-vision:

• hand, hands, finger, fingers
• face, facial, portrait, eyes, nose, mouth
• body, person, human, skin, people
• realistic, photo, photograph

Keywords that trigger lama (removal):

• remove, delete, erase, cleanup
• disappear, hide, clear

Default: sdxl-inpaint

• Everything else uses SDXL for best general quality

Example Auto-Selection:

# User prompt: "Fix the hand" → auto-selects realistic-vision
# User prompt: "Remove the person" → auto-selects lama
# User prompt: "Change to sunset" → auto-selects sdxl-inpaint

---

Manual Model Override

Via Environment Variable

Set default model in .env:

REPLICATE_MODEL=realistic-vision

Via API Request

Override per-edit in the API:

{
  "prompt": "Fix the hand",
  "ai_provider": "replicate",
  "ai_model": "realistic-vision",
  "mode": "A",
  ...
}

Via Frontend (Future Feature)

Model selector dropdown in the UI.

---

Cost Optimization Strategies

For Low-Volume Users (< 100 edits/month)

Recommendation: Use Replicate with auto-selection

Why:

• No minimum purchase
• Pay only for what you use
• Auto-selects cheapest appropriate model

Estimated Cost: $1-3/month

---

For Medium-Volume Users (100-1000 edits/month)

Recommendation: Replicate or Stability AI

Strategy:

• Use lama for removals ($0.002/image)
• Use realistic-vision for humans ($0.020/image)
• Use sdxl-inpaint for general ($0.025/image)

Estimated Cost: $10-30/month

---

For High-Volume Users (1000+ edits/month)

Recommendation: Consider local GPU or cloud GPU

Why:

• No per-image cost
• Best quality control
• Privacy

Setup:

• Local: RTX 3060+ GPU ($300-2000 one-time)
• Cloud: RunPod/Vast.ai ($0.30-1.00/hour)

---

Quality Comparison Table

Use Case	DALL-E 2	Stability SDXL	Replicate SDXL	Replicate Realistic	Replicate LaMa
Hands	⭐⭐	⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐
Faces	⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐
Bodies	⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐
Objects	⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐	N/A
Landscapes	⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐	N/A
Removal	⭐⭐	⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐⭐
Creative	⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐

---

Advanced Tips

For Difficult Hands

1. Use Mode B - Provides full image context
2. Be specific - "realistic five-fingered hand in natural pose"
3. Multiple passes - Fix gross errors first, then refine
4. Reference images - Mode B helps AI understand the pose

For Facial Features

1. High feather value - 10-15px for smooth blending
2. Small selections - Target specific features
3. Natural lighting - Mention lighting in prompt

For Body Parts

1. Maintain proportions - Use Mode B for body context
2. Clothing context - Include clothing description in prompt
3. Skin tone consistency - Mention skin tone if needed

---

Troubleshooting Common Issues

"Hands have too many fingers"

• Solution: Switch to realistic-vision model
• Prompt: "realistic human hand with exactly five fingers"
• Try: Multiple generations, pick best result

"Face looks unnatural"

• Solution: Use realistic-vision model
• Increase: Feather value to 15-20px
• Try: Mode B for better context

"Removal leaves artifacts"

• Solution: Use lama model (designed for removal)
• Alternative: SDXL with prompt "clean background"

"Colors don't match"

• Increase: Feather value to 20-30px
• Try: Mode B for better color context
• Prompt: Include color description

---

Quick Start Examples

Example 1: Fix a Hand

{
  "prompt": "realistic human hand with five fingers, natural pose",
  "ai_provider": "replicate",
  "ai_model": "realistic-vision",
  "mode": "B",
  "feather_px": 10
}

Example 2: Remove an Object

{
  "prompt": "remove the object, clean background",
  "ai_provider": "replicate",
  "ai_model": "lama",
  "mode": "A",
  "feather_px": 5
}

Example 3: Change Sky

{
  "prompt": "sunset sky with orange and pink clouds",
  "ai_provider": "replicate",
  "ai_model": "sdxl-inpaint",
  "mode": "A",
  "feather_px": 15
}

---

Summary

For Body Parts: Use realistic-vision (Replicate) For Removal: Use lama (Replicate) For Everything Else: Use sdxl-inpaint (Replicate or Stability)

Let the auto-selection do its job - it's optimized for these use cases!