mrkeyoor.com_
Fri 16 Oct 18:51 UTC
AI Toolsevaluationupdated 12 Oct 2026

3dicon review

3dicon is a Claude Code plugin and Python pipeline that turns a prompt or still image into a looping animated icon with a transparent background. It combines hosted image and video generation with local background removal and WebP encoding for app artwork.

+5 / 3dstars / 7d
Verdict

3dicon installed 57 packages and used 520 MB in our sandbox, then built in 2 seconds, but tests were skipped because no target existed. It is worth a trial for app icons when you can approve paid generation stages and inspect each exported loop. Skip it for offline generation or transparent MP4 delivery, and ship the still alongside the animation for reduced motion.

We ran it

Lab card: what happened when we ran 3diconScreenshot of 3dicon (github.com/samyost1/3dicon)
Install✓ · 15s57 packages · 520 MB
Build✓ · 2s
Testsn/ano test script
Known vulns0(pip-audit)
Repo27 files~1,387 lines of source · 3.8 MB · 0 CI workflows

Answers from our run

Does 3dicon build from source?

Dependencies installed in 15 seconds (57 packages), and the build succeeded in 2 seconds. We cloned commit 9539d3a into a clean Debian container with 3 CPUs and no project-specific setup.

Does 3dicon have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does 3dicon have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use 3dicon?

Offline-only teams: the README routes image and video generation through hosted models and an API key.

What are the alternatives to 3dicon?

Blender, Lottie Web. 3dicon installed 57 packages and used 520 MB in our sandbox, then built in 2 seconds, but tests were skipped because no target existed.

Setup3/515-second install; ffmpeg, API access, and backend selection remain
Docs3/5Useful limitations; one-key README conflicts with image default
Community2/5Recent push; the single visible issue has no explanatory body
Maturity2/5Build passes, but tests are absent and paid generation unverified

Who it’s for

Claude Code users who want a generated animated app icon and will approve the still and motion separately.
App developers comfortable with hosted generation credentials, ffmpeg, and local image processing.
Designers prepared to inspect transparency and loop behavior on their actual UI backgrounds.

Who it’s NOT for

Offline-only teams: the README routes image and video generation through hosted models and an API key.
Apps requiring transparent MP4 output: the limitations document says MP4 export uses a solid background.
Designers relying on soft contact shadows: matting removes them, and the documented restoration workaround isn't implemented.
Teams expecting animated WebP to respect reduced motion automatically: the limitations require swapping to a still in the app.
Developers requiring a measured passing suite: our sandbox found no test target and skipped tests.

Setup reality

Our sandbox installed commit 9539d3a from skills/3dicon/ in 15 seconds with 57 packages and a 520 MB footprint. The build succeeded in 2 seconds, tests were skipped because no target existed, and pip-audit reported 0 known vulnerabilities. The October 12, 2026 run used Python 3.12 on Debian with 3 CPUs, 8 GB of RAM, and no secrets.

Hosted image and motion stages need provider access. For the README's single OpenRouter-key route, set ICONLOOP_IMAGE_BACKEND=openrouter: the checked-in example and CLI default to openai. The Claude Code workflow asks for separate still and motion approvals.

Ffmpeg must be on PATH, and the first use downloads matting weights. MP4 output is opaque, soft contact shadows are lost, and reduced-motion handling requires an app-level still fallback. Our build result doesn't verify a paid generation or its visual quality.

A transparent loop still needs a human approval step

3dicon generates a still image, sends it to a video model, removes the background from the resulting frames, and writes an animated WebP. The same still supplies both ends of the video request to encourage a closed loop. That targets a specific app-design job: a small illustrated object that moves on screen without sitting inside an opaque rectangle. The repository includes a stopwatch example and the intermediate art used to make it.

Our checkout was only 3.8 MB across 27 files, but using it commits you to more than downloading a picture. The Claude Code workflow stops for approval of the still and then the proposed motion. I like that division because a rejected design shouldn't automatically become a paid video request. The CLI also separates generation, animation, matting, encoding, and verification, so you can inspect artifacts between stages instead of accepting whatever arrives at the end.

What happened when we ran it

Our sandbox installed commit 9539d3a in 15 seconds, adding 57 packages and occupying 520 MB. The build succeeded in 2 seconds. We ran the Python project under skills/3dicon/ on October 12, 2026, using ghcr.io/astral-sh/uv:python3.12-bookworm, with 3 CPUs and 8 GB of RAM. This was a fresh, unprivileged Debian container with no secrets, which limits what these results establish about the hosted generation stages.

There was no test script or target, so tests were skipped. Pip-audit reported 0 known vulnerabilities, and our scan found 0 CI workflow files, no Dockerfile, and no tests directory. The successful build shows that the measured build step completed. It doesn't demonstrate that a provider accepted a generation request, that a loop closed cleanly, or that the resulting alpha channel looked right. We have no measured output-quality or paid-generation timing result to report.

The one-key route requires changing the image backend

The README describes OpenRouter as a single credential for both image and video generation. However, the checked-in .env.example sets ICONLOOP_IMAGE_BACKEND=openai, and the CLI uses the same default. To follow the one-key route, change that setting to openrouter or select it explicitly. Otherwise, the image stage asks for OPENAI_API_KEY. That is a concrete setup mismatch worth fixing before you assume the README's short credential instructions are sufficient.

The 520 MB footprint we measured is also more useful for planning than the small checkout alone. The runtime needs ffmpeg on PATH and retrieves matting weights on first use, according to the README. Those requirements sit outside the promise of a successful Python build. Hosted models require credentials and provider access. The image code can choose from the provider's model catalog unless you override the model, so record what a successful generation actually used when repeatability matters.

Output checks help, but the suite was skipped

The source verifier compares movement between frames, checks the transition from the final frame back to the first, and examines animated WebP structure and partial transparency. It also produces a contact sheet against light and dark backgrounds. Those checks address recognizable mistakes: an almost static video, a visible loop hitch, or edges that look acceptable only against one surface. They are more useful than accepting a file merely because an encoder wrote it.

Our 2-second build didn't exercise those checks on a newly generated asset, and the skipped test step leaves a gap in developer assurance. Treat the verifier as part of your own export review. A contact sheet helps reveal edge problems, while playback is necessary to judge the motion. The first-and-last-frame technique encourages the model to return to the starting pose. The existence of a seam check is a sensible acknowledgment that the request alone isn't enough.

Shadows, MP4 transparency, and reduced motion need extra work

The limitations document says matting removes soft contact shadows, leaving some icons looking ungrounded on light backgrounds. It proposes restoring a static shadow layer, but says that workaround isn't implemented. Check the animation on the actual screen where you plan to use it. A dark preview can hide a problem that is obvious on a pale card.

The 57-package setup gives you encoding machinery, not every delivery format an app might need. MP4 export flattens the artwork onto a solid background, so don't choose it when transparency is required. Animated WebP also needs application logic to swap in a still for reduced-motion preferences. Keep the static asset alongside the loop. If your design requires a controllable vector animation, Lottie Web is a more appropriate starting point, though it renders authored animations rather than generating 3D art from a prompt.

September activity leaves support history too thin to judge

GitHub reports a September 23, 2026 last push, 555 stars, and 1 open issue and PR combined. The latest-release endpoint returns no published release. The visible open issue, titled Icone, was updated September 24 and has no explanatory body. It supplies no evidence about a particular defect. The recent push supports describing this as a small recent project, while the release and issue history give little basis for judging ongoing support.

A 15-second install makes a trial easy, provided you accept the external generation services and inspect each result. Blender is the stronger choice when you need direct control over the object, lighting, and motion, and can spend time authoring them. I'd use 3dicon for a reviewed app accent, with the chosen provider recorded and a still ready for reduced motion. Put the loop on your lightest real UI surface before approving it.

Alternatives

ProjectWhat it isPick it when
Blender gh↗A 3D authoring application for modeling, lighting, and animating your own assets.pick this instead when exact geometry and motion control justify manual authoring.
Lottie WebA browser player for animations exported from After Effects through Bodymovin.pick this instead when you need playback control over an authored vector animation rather than a generated raster loop.

What people are saying

  1. [velocity-scout] samyost1/3dicon

Sources

  1. 3dicon README
  2. Known output limitations
  3. Image backend configuration example
  4. CLI defaults and stages
  5. Asset verifier source
  6. Repository facts and activity
  7. Blender
  8. Lottie Web

More ai tools reviews

universal-modder · DeepEP-Ascend · DeepGEMM-Ascend · hypoarena · jeeves · faster-whisper · the whole board →