3dicon README

The project's README from github.com/samyost1/3dicon. As one markdown file: README.md.

/3dicon

One prompt in, a looping animated 3D icon out (with real transparency) an animated WebP you can drop straight into your app UI.

eight icons looping around the /3dicon wordmark

Install

/plugin marketplace add samyost1/3dicon
/plugin install 3dicon

One OpenRouter key covers the whole pipeline — the image model and the video model both run through it.

cd ~/.claude/skills/3dicon
pip install -r requirements.txt
cp .env.example .env

Put your key in .env:

OPENROUTER_API_KEY=sk-or-...

Get one at openrouter.ai/keys.

ffmpeg must be on PATH. The first run downloads a ~180MB matting model.

Use

Ask for it in plain words:

make an animated 3d fire icon using /3dicon

It generates one still, shows it, and waits for you to approve it before spending anything on motion. Then it proposes the motion and waits again.

How it works

flowchart LR
    P["your prompt"] --> S["still image<br/><sub>GPT Image</sub>"]
    S --> F["first frame"]
    S --> L["last frame"]
    F --> V["video model<br/><sub>Seedance</sub>"]
    L --> V
    V --> M["remove background<br/><sub>every frame</sub>"]
    M --> E["animated .webp<br/><sub>real alpha</sub>"]

The trick is in the middle: the same still is sent as both the first and the last frame, so the model returns to where it began and the loop closes with no visible seam.

The background is removed against a colour we chose ourselves, which means the original colours can be solved for exactly rather than guessed — that is what keeps soft edges soft instead of leaving a halo.

Licence

MIT. Icons you generate with it are yours, with no restrictions.

3dicon (samyost1/3dicon)

Searching Database…

561 ·GitHub
Что это такое?Это навык (skill) для Claude Code: на входе один простой запрос обычными словами, на выходе — зацикленная анимированная 3D-иконка, то есть анимированный WebP с настоящей прозрачностью, который можно сразу вставить в интерфейс приложения.
Это отдельное приложение или оно живёт внутри Claude Code?Это навык для Claude Code, а не отдельное приложение — вы просто просите иконку обычными словами, например «сделай анимированную 3D-иконку огня через /3dicon», и он сам прогоняет весь пайплайн.
Как всё настроить?Получите ключ OpenRouter (одного ключа хватает на весь пайплайн), положите его в .env и убедитесь, что ffmpeg доступен в PATH — после этого просто попросите Claude сделать иконку.
Что стоит знать перед первым запуском?ffmpeg должен быть в PATH, а при первом запуске скачается модель для маттинга размером около 180 МБ. Генерация идёт через модели OpenRouter, так что это не полностью локальный инструмент.
Могу ли я использовать сгенерированные иконки в своих проектах?Да — код распространяется по лицензии MIT, а в README сказано, что созданные с его помощью иконки принадлежат вам без каких-либо ограничений.
Нужна мощная видеокарта или можно запустить на ноутбуке?Обычного железа достаточно: модели для картинок и видео вызываются через OpenRouter, поэтому локально нужны только ffmpeg плюс загрузка модели для маттинга на ~180 МБ при первом запуске.
Генерация иконки бесплатная?Сам навык бесплатный и распространяется по MIT, но шаги с картинкой и видео идут через платные модели OpenRouter — именно поэтому он спрашивает ваше подтверждение, прежде чем тратить деньги на анимацию.
Creator
samyost1
Size
7.6 MB
Stars
561
Updated
CommitSep 23
Age
24d
Commits · 90 Days