How samyost1/3dicon works
3dicon is a prompt-driven tool for creating looping 3D icons with transparent animation. Its workflow generates a still, pauses for human review, composes and approves motion, renders a loop, removes the chosen backing color frame by frame, then normalizes and encodes the result. The CLI coordinates these paid and time-consuming stages; verification reports catch motion, seam, and alpha issues. The README documents multiple image and video backends plus WebM and flat MP4 exports. Some CLI wiring is inferred from the sampled excerpts and README, so uncertain links are omitted.
Main entry points: cli.py CLI workflow · kling.py Video rendering · providers.py Still image generation · encode.py Animation encoding
Components 20
Prompt and Motion
- CLI workflow
skills/3dicon/iconloop/cli.py - Motion composer
skills/3dicon/iconloop/motion.py
Image and Video Generation
- Still image generation
skills/3dicon/iconloop/providers.py - Image model APIs
- Video rendering
skills/3dicon/iconloop/kling.py - OpenRouter video API
- Replicate API
- Backing composite
skills/3dicon/iconloop/kling.py
Transparency and Export
- Frame extraction
skills/3dicon/iconloop/matte.py - Alpha matting
skills/3dicon/iconloop/matte.py - Matting model
- Framing normalization
skills/3dicon/iconloop/matte.py - Animation encoding
skills/3dicon/iconloop/encode.py - Output verification
skills/3dicon/iconloop/verify.py
Runtime Support
- HTTP helpers
skills/3dicon/iconloop/http.py - Key configuration
skills/3dicon/iconloop/config.py
Other components
- User
- Human reviewer
- Icon outputs
- ffmpeg
Connections 28
- User → CLI workflow: requests icon
- CLI workflow → Still image generation: generates still
- CLI workflow → Human reviewer: presents still
- Human reviewer → CLI workflow: approves stage
- CLI workflow → Motion composer: composes motion
- CLI workflow → Video rendering: starts render
- Video rendering → Backing composite: composites still
- CLI workflow → Backing composite: prepares image
- Video rendering → OpenRouter video API: submits video job
- Video rendering → Replicate API: submits video job
- Still image generation → Image model APIs: requests image
- Still image generation → HTTP helpers: sends requests
- Video rendering → HTTP helpers: sends requests
- Still image generation → Key configuration: reads keys
- Video rendering → Key configuration: reads keys
- CLI workflow → Key configuration: loads settings
- CLI workflow → Frame extraction: extracts render
- Frame extraction → ffmpeg: decodes frames
- CLI workflow → Alpha matting: mattes frames
- Alpha matting → Matting model: estimates alpha
- CLI workflow → Framing normalization: normalizes frames
- CLI workflow → Animation encoding: encodes formats
- Animation encoding → ffmpeg: encodes video
- CLI workflow → Output verification: checks outputs
- CLI workflow → Icon outputs: writes work files
- Animation encoding → Icon outputs: writes animations
- Output verification → Icon outputs: reads outputs
- Human reviewer → Icon outputs: reviews still