mcpField
E
eye-color-changer

eye-color-changer

github.com/eachlabsCreative & media44184 installsUpdated today
Repository

About eye-color-changer

eye-color-changer is an each::sense-based skill for editing eyes in photos, aimed at realistic retouching and creative portraits. It supports natural and fantasy colors, heterochromia, and special effects while preserving iris detail and reflections.

Key features

  1. 01Natural and fantasy eye color changes
  2. 02Heterochromia and pupil effects
  3. 03Glowing eyes and patterns
  4. 04Enhance existing eye color
  5. 05Generate multiple options from one photo
  6. 06Preserve iris texture and reflections

Use cases

  1. 01Change eye color in portraits
  2. 02Create fantasy or cosplay effects
  3. 03Enhance existing eye color in photos

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/eachlabs/skills --skill eye-color-changer

After installing, type/eye-color-changerin Claude Code to confirm it loaded.

Bundled filesreferences/SSE-EVENTS.md

Details

From the project README

Eye Color Changer

Transform eye colors in photos using each::sense. This skill enables realistic eye color changes, fantasy effects, and creative eye modifications while maintaining natural appearance and proper iris detail.

Features

  • Natural Color Changes: Blue, green, brown, hazel, gray, amber
  • Fantasy Colors: Purple, red, golden, silver, white
  • Heterochromia: Different colors for each eye
  • Special Effects: Cat/slit pupils, glowing eyes, hypnotic patterns
  • Color Enhancement: Intensify natural eye colors
  • Batch Processing: Multiple color options from a single photo
  • Realistic Blending: Maintains natural iris texture and reflections

Quick Start

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Change the eye color to bright blue in this photo"}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'

Supported Eye Color Options

CategoryColorsBest For
NaturalBlue, green, brown, hazel, gray, amberRealistic transformations
FantasyPurple, violet, red, golden, silverCreative/artistic portraits
SpecialGlowing, cat-eye, heterochromiaFantasy characters, cosplay
EnhancedVivid versions of natural colorsMaking eyes pop in photos

Use Case Examples

1. Change to Blue Eyes
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Change the eye color to a natural bright blue. Keep the iris texture and reflections realistic. The blue should look like natural blue eyes, not contact lenses."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'
2. Change to Green Eyes
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Transform the eye color to emerald green. Maintain natural iris patterns and make sure the color blends realistically with the skin tone around the eyes."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'
3. Change to Brown Eyes
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Change the eyes to warm brown color. Make it look like natural dark brown eyes with subtle golden flecks in the iris for realism."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'
4. Change to Hazel Eyes
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Transform the eye color to hazel - a natural blend of green and brown with golden undertones. The color should transition from darker near the pupil to lighter at the edges of the iris."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'
5. Fantasy Colors (Purple, Red, Golden)
# Purple/Violet Eyes
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Change the eye color to a deep violet purple. Make it look otherworldly but still maintain realistic iris texture. Perfect for a fantasy or cosplay character look."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'

# Red Eyes
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Transform the eyes to a striking crimson red color. Keep the iris detail and make it look like supernatural red eyes - vampire or demon aesthetic."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'

# Golden Eyes
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Change the eye color to golden yellow, like a wolf or supernatural being. Maintain realistic iris patterns but with a luminous golden color."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'
6. Heterochromia (Different Colored Eyes)
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create heterochromia - make the left eye bright blue and the right eye emerald green. Both eyes should look natural and realistic, just different colors from each other."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'
7. Cat/Slit Pupil Effect
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Transform the eyes to have cat-like vertical slit pupils with golden yellow iris color. Make it look like feline or reptilian eyes while keeping the overall eye shape natural to the face."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'
8. Glowing Eyes Effect
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Make the eyes glow with an ethereal blue light. Add a subtle luminous effect that makes the eyes appear to emit light, with a soft glow around the iris. Perfect for a supernatural or magical character effect."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'
9. Natural Color Enhancement
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Enhance the natural eye color to make it more vivid and striking. Intensify the existing color, add more depth and clarity to the iris, and make the eyes really pop without changing the base color."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "mode": "max"
  }'
10. Multiple Color Options from Same Photo
# Use session_id to generate multiple variations
# First variation - Blue
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Change the eye color to bright blue. Keep it natural looking."}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "session_id": "eye-color-variations-001",
    "mode": "eco"
  }'

# Second variation - Green (same session)
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Now create another version with emerald green eyes instead."}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "eye-color-variations-001",
    "mode": "eco"
  }'

# Third variation - Hazel (same session)
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create one more version with hazel eyes."}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "eye-color-variations-001",
    "mode": "eco"
  }'

Best Practices

For Realistic Results
  • High-quality source images: Use well-lit photos where eyes are clearly visible
  • Front-facing portraits: Best results with eyes looking toward the camera
  • Describe iris details: Mention if you want specific patterns, flecks, or gradients
  • Natural lighting reference: Mention the lighting style for consistent reflections
For Fantasy Effects
  • Specify the aesthetic: Vampire, alien, anime, supernatural, etc.
  • Describe intensity: Subtle glow vs. bright luminescence
  • Include character context: Helps AI match the overall style
Prompt Tips
  1. Be specific about shade: "Ice blue" vs. "ocean blue" vs. "navy blue"
  2. Mention blending: Ask for natural transitions at iris edges
  3. Request iris texture: Preserve or modify the natural patterns
  4. Consider lighting: Specify if you want reflections maintained

Mode Selection

ModeBest ForSpeedQuality
maxFinal photos, professional use, detailed effectsSlowerHighest
ecoQuick previews, batch variations, testing colorsFasterGood

Multi-Turn Creative Iteration

Use session_id to refine eye color changes:

# Initial change
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Change the eye color to blue"}],
    "model": "eachsense/beta",
    "stream": true,
    "image_urls": ["https://example.com/portrait.jpg"],
    "session_id": "eye-edit-project"
  }'

# Refine the result
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Make the blue more intense and add a slight ring of darker blue around the edge of the iris"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "eye-edit-project"
  }'

# Add special effect
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Now add a subtle glow effect to make the eyes look magical"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "eye-edit-project"
  }'

Error Handling

ErrorCauseSolution
Failed to create prediction: HTTP 422Insufficient balanceTop up at eachlabs.ai
No eyes detectedFace not visible or eyes closedUse a photo with clearly visible open eyes
Unnatural blendingPoor source image qualityUse higher resolution, well-lit photos
TimeoutComplex generationSet client timeout to minimum 10 minutes

Related Skills

  • each-sense - Core API documentation
  • face-swap - Face swapping capabilities
  • image-edit - General image editing
  • portrait-generation - AI portrait creation

Comments

Markdown supported