Skip to content

andyed/iblipper-agent

Repository files navigation

iBlipper

Kinetic Typography for AI Agents.

→ See it in action

iBlipper allows AI agents to communicate with visual flair using animated text. It supports:

  • Web Links: Shareable URLs that play animations.
  • PWA Protocol: Direct deep-linking to the iBlipper PWA.
  • MCP Server: Universal skill for Claude Desktop and other MCP-compliant agents.

📦 Install via skills.sh: skills.sh/andyed/iblipper-agent/iblipper

Installation

Via uv (Recommended)

uv tool install iblipper-agent

From Source

git clone https://github.com/andyed/iblipper-agent.git
cd iblipper-agent
pip install .

Usage

CLI

# Generate a link
iblipper.sh "Hello World"

# PWA Protocol
iblipper.sh --pwa "Hello World"

Note: The script is located at src/iblipper/scripts/iblipper.sh.

MCP Server (Claude Desktop)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "iblipper": {
      "command": "uv",
      "args": ["tool", "run", "iblipper-server"]
    }
  }
}

Local GIF Generation (Owning the File)

You can generate GIFs locally using the included renderer (requires Playwright).

Via Python:

import asyncio
from iblipper.renderer import render_gif

asyncio.run(render_gif(
    "https://andyed.github.io/iblipper2025/?export=gif#text=Hello",
    "output.gif"
))

Via MCP Tool: Use render_gif_file(message="Hello", output_path="hello.gif").

Optimization for X (Twitter)

For best results when sharing on X:

  • Format: GIF, JPG, or PNG.
  • Size Limit:
    • Web: Up to 15MB
    • Mobile: Up to 5MB
  • Aspect Ratio: Between 1:1 (Square) and 3:1 (wider formats work best in feed).
  • Length: Short loops (3-10 seconds) capture attention most effectively.

Note: iBlipper's default settings are optimized for these constraints.