clawcap-avatar-equip

Category: Content & Multimedia | Uploader: ls569333469 | Downloads: 0 | Version: v1.0（Latest）

AI-powered avatar accessory synthesis — automatically analyzes art style, lighting, and angle to seamlessly add hats and headwear to any avatar image.

Changelog: Source: GitHub https://github.com/ls569333469/The-ClawCap

Directory Structure

Current level: Root

📁 api/
- 📄 __init__.py 0 B
- 📄 routes.py 5.7 KB
- 📄 schemas.py 1.9 KB
📁 assets/
- 📄 clawcap-logo.jpg 807.2 KB
📁 core/
- 📄 __init__.py 0 B
- 📄 inpainter.py 4.6 KB
- 📄 mask_generator.py 3.1 KB
- 📄 vision_fingerprint.py 4.0 KB
📁 static/
- 📄 index.html 20.9 KB
📁 utils/
- 📄 __init__.py 0 B
- 📄 image_utils.py 2.3 KB
📄 .env.example 117 B
📄 .gitignore 205 B
📄 config.py 963 B
📄 main.py 1.9 KB
📄 mcp_server.py 4.0 KB
📄 README.md 3.3 KB
📄 requirements.txt 183 B
📄 SKILL.md 1.7 KB

SKILL.md

---
name: clawcap-avatar-equip
description: AI-powered avatar accessory synthesis — automatically analyzes art style, lighting, and angle to seamlessly add hats and headwear to any avatar image.
---

# 🦞🧠 The ClawCap — Avatar Accessory Skill

When the user wants to **add a hat, headwear, or accessory to an avatar image**, use this skill.

## What It Does

ClawCap uses a 3-stage AI pipeline to add accessories to any avatar:

1. **VLM Fingerprint** — Gemini Vision analyzes the avatar's art style, lighting, color palette, and head position
2. **Mask Generation** — Automatically creates a pixel-precise placement mask using Pillow/NumPy
3. **AI Inpainting** — Gemini generates the accessory that perfectly matches the original style

## Supported Styles

- 📷 Real photos
- 🎨 Anime / 2D illustrations
- 🧊 3D renders
- 👾 Pixel art / NFT avatars

## How to Use

### As MCP Skill (Claude Desktop)

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "clawcap": {
      "command": "python",
      "args": ["mcp_server.py"],
      "cwd": "/path/to/The-ClawCap"
    }
  }
}
```

Then tell Claude: *"给这个头像戴上一顶龙虾帽"* with an image attached.

### As Web API

```bash
POST http://localhost:8000/api/skill/alpha-equip
Content-Type: application/json

{
  "image_base64": "<base64 encoded image>",
  "accessory_prompt": "a red lobster claw beanie hat"
}
```

### Live Demo

🌐 **[Try it online](http://107.172.78.150:8000)** (Rate limited: 3 requests/minute per IP)

## Requirements

- Python 3.10+
- `GEMINI_API_KEY` environment variable (get one at https://aistudio.google.com/apikey)
- Install deps: `pip install -r requirements.txt`

## Repository

🔗 [GitHub: The-ClawCap](https://github.com/ls569333469/The-ClawCap)

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

clawcap-avatar-equip

Directory Structure

SKILL.md

Report

Notice