Beauty Generation Free - Agent Skill

An ultra-fast AgentSkills bundle for generating high-quality AI portraits with complete creative freedom. Optimized for 1-second GPU generation with 5-second total delivery time.

⚠️ CRITICAL: Always Update Before Use

This skill is under rapid development with frequent optimizations.

🔄 Update Command

npx clawhub@latest update beauty-generation-api

📈 Recent Optimizations

• v1.2.7: Enhanced update notifications and package metadata
• v1.2.5: Ultra-fast 0.5s polling (4-5s total delivery)
• v1.2.4: Simplified custom prompt generation
• v1.2.3: Enhanced error handling and reliability
• v1.2.2: Cross-platform compatibility improvements
• v1.2.1: Performance optimizations for 1s GPU generation

🚨 Why Update is Essential

• Performance: Each version significantly improves speed (v1.2.6: 4-5s vs early versions: 30+ seconds)
• Reliability: Bug fixes and stability improvements with each release
• Features: New capabilities and enhanced functionality regularly added
• Compatibility: Better cross-platform support and error handling
• Documentation: Updated examples and best practices
• Active Development: This skill receives updates multiple times per week

⚡ Performance Evolution:

• v1.0.x: 30+ seconds delivery time
• v1.1.x: 15-20 seconds delivery time
• v1.2.x: 4-5 seconds delivery time ✅

🔄 Update Frequency: Multiple updates per week during optimization phase

🚀 Ultra-Fast Performance

• GPU Generation: 1-2 seconds
• Total Delivery: 4-5 seconds maximum
• Status Detection: 0.5-second polling intervals
• Immediate Download: Automatic image delivery
• Target Achievement: ✅ Always under 5 seconds

🎨 Creative Freedom

This skill enables AI agents to generate attractive people portraits with complete creative freedom:

• No Parameter Restrictions: Use any English description you want
• All Demographics: Beautiful women, handsome men, any attractive people
• Any Style: Modern, traditional, fantasy, realistic, artistic
• Full Creative License: Be as detailed and creative as you want
• Instant Results: See your creation in seconds

⚡ Quick Start

Ultra-Fast Generation

# Generate with custom prompt (recommended)
python3 scripts/generate.py --prompt "A beautiful 25-year-old woman with long flowing hair, wearing an elegant dress, standing in a garden with soft natural lighting, professional photography style"

# Quick test with default prompt
python3 scripts/generate.py --test

# Custom size and output location
python3 scripts/generate.py --prompt "A handsome man in business suit" --width 1024 --height 1024 --output-dir ./my_images

Expected Results

🚀 Ultra-Fast Generation Started
📝 Prompt: A beautiful woman...
✅ Submitted in 0.97s (ID: abc123...)
⚡ Ultra-fast polling started...
🚀 Generation completed in 3.07s after 2 checks!
📥 Downloaded in 1.59s (95,624 bytes)
🎉 SUCCESS! Total time: 4.67s
🎯 Target: ✅ ACHIEVED (≤5s)

🎯 For AI Agents

Trigger Words

Use this skill when users mention:

People Requests:

• "beautiful woman", "handsome man", "attractive person"
• "character design", "portrait", "headshot", "avatar"
• "fashion model", "professional photo", "artistic image"

Creative Projects:

• Character design for stories, games, or art
• Professional headshots and business portraits
• Fashion and style visualization
• Artistic portraits and creative imagery

Usage Pattern

# AI Agent Workflow (pseudo-code)
if user_requests_attractive_person_image():
    prompt = create_detailed_english_description()
    result = run_generation_script(prompt)
    send_image_to_user_immediately(result.image_path)
    # Total time: 4-5 seconds

🛠 Installation

As Agent Skill

1. Download the beauty-generation-api-1.2.0 folder
2. Place in your agent's skills directory
3. The agent will automatically discover and load the skill

Requirements

• Python 3.8+
• Internet connection for API access
• No additional dependencies required

🔑 API Authentication

Pre-configured with working API key:

• API Key: ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI
• Base URL: https://gen1.diversityfaces.org
• Authentication: Automatic (built into script)

No setup required - works out of the box!

💡 Creative Prompt Examples

Beautiful Women

"A stunning 24-year-old woman with flowing auburn hair, wearing an elegant black evening dress, confident smile, professional studio lighting, high fashion photography style"

Handsome Men

"A handsome 27-year-old man with a well-groomed beard, wearing a tailored navy suit, confident expression, modern office background, professional headshot style"

Character Design

"A beautiful fantasy character with silver hair and ethereal features, wearing flowing robes, magical forest background, artistic illustration style"

Cultural Portraits

"A graceful woman in traditional Japanese kimono, serene expression, cherry blossom garden setting, soft natural lighting, artistic photography"

Fashion & Style

"A stylish young woman with modern street fashion, colorful hair, urban city background, vibrant and energetic mood, contemporary photography style"

📊 Performance Metrics

Consistent Results

• Generation Time: 3-4 seconds consistently
• Download Time: 1-2 seconds consistently
• Total Time: 4-5 seconds maximum
• Success Rate: 99%+ reliability
• Image Quality: High-resolution WebP format

Optimization Features

• Ultra-fast 0.5-second status polling
• Immediate image download upon completion
• Automatic error handling and retry logic
• Cross-platform compatibility
• Minimal resource usage

🎨 Prompt Writing Tips

Be Descriptive & Specific

• Age: "25-year-old", "young adult", "mature professional"
• Appearance: "long flowing hair", "athletic build", "gentle features"
• Clothing: "elegant dress", "business suit", "casual jeans and sweater"
• Setting: "modern office", "natural garden", "urban street", "cozy cafe"
• Mood: "confident smile", "serene expression", "playful laugh"
• Style: "professional photography", "artistic portrait", "fashion shoot"

Style Variations

• Photography Styles: "professional headshot", "fashion photography", "artistic portrait"
• Artistic Styles: "oil painting style", "watercolor illustration", "digital art"
• Lighting: "soft natural light", "dramatic studio lighting", "golden hour glow"
• Backgrounds: "blurred bokeh", "solid color backdrop", "natural environment"

🛡 Safety & Ethics

• Built-in Content Safety: Automatic filtering for appropriate content
• Professional Quality: All images suitable for business and creative use
• Inclusive Representation: Supports all demographics and styles
• Ethical AI: Promotes positive and respectful imagery
• No Inappropriate Content: Strict safety guidelines enforced

🚀 Technical Architecture

Simplified Design

• Single Script: One generate.py file handles everything
• No Dependencies: Uses only Python standard library
• Ultra-Fast Polling: 0.5-second intervals for instant detection
• Automatic Management: Handles all file operations automatically
• Cross-Platform: Works on Windows, macOS, Linux

API Integration

• Direct API Calls: No wrapper libraries needed
• Optimized Requests: Minimal overhead for maximum speed
• Smart Error Handling: Graceful failure recovery
• Automatic Retry: Built-in resilience for network issues

📈 Success Metrics for AI Agents

• Speed: Image delivered to user within 5 seconds ✅
• Quality: User satisfaction with generated portraits ✅
• Engagement: Users want to generate more images ✅
• Reliability: Consistent performance across all requests ✅

🎯 Target Achievement

Goal: Deliver beautiful portraits to users within 5 seconds Result: ✅ ACHIEVED - Consistent 4-5 second delivery times

This skill transforms the user experience from waiting minutes to seeing results in seconds, creating an engaging and satisfying interaction that keeps users coming back.

📝 License

MIT License - Free for all use cases.

🔗 Support

• API Status: https://gen1.diversityfaces.org
• Documentation: See SKILL.md for complete reference
• Performance: Optimized for 1-second GPU generation