SpinForge AI
SpinForge AI is an open-source, AI-assisted 360° object and logo spin video generator built with Python, Flask, Pillow, OpenCV, and FFmpeg.
SpinForge AI is an AI-assisted 360° object and logo spin video generator. Upload an image, choose a rotation style, optionally remove the background, pick a solid background color, and export a browser-compatible MP4 — all from a lightweight, responsive Flask web app.
A note on realism: a single flat image cannot create true 3D side and back views. SpinForge AI produces clean 2D 360-style motion loops. For true object 360° output, use multi-angle photography or a 3D-model workflow.
Key features
- Stable, centered 360° frame rendering with no object drift.
- Optional AI background removal powered by
rembg. - Solid custom HEX background color.
- Four rotation modes: Center Circular 360, Horizontal 360, Vertical 360, and Smooth Logo 360.
- FFmpeg H.264 MP4 encoding (
yuv420p,faststart) with an OpenCV fallback encoder when FFmpeg is unavailable. - UUID file names, secure upload validation, rate limiting, and temporary-file cleanup.
- Responsive, step-based Flask/Jinja frontend with built-in SEO, Open Graph, Twitter cards, JSON-LD, sitemap, and robots.txt.
Rotation modes
- Center Circular 360 — continuously rotates the image plane from 0° to 360°.
- Horizontal 360 — a front-edge → mirrored-back-edge → front visual illusion from one image.
- Vertical 360 — a front-edge → flipped-back-edge → front visual illusion from one image.
- Smooth Logo 360 — continuous center rotation with subtle scale “breathing”.
How background removal works
Background removal is optional and disabled by default.
- Disabled: the complete uploaded image is resized, centered, and rendered on the chosen background color.
- Enabled:
rembgremoves the background, alpha-bounding-box detection crops the object once, and the object is normalized on a fixed transparent canvas before frames are rendered.
Technology stack
Python 3.11+ · Flask · Jinja · Pillow · OpenCV · FFmpeg · rembg / onnxruntime ·
HTML5 / CSS3 / JavaScript · SQLite (local generation history).
Requirements
- Python 3.11 or newer
- FFmpeg (recommended for production-quality MP4 output; an OpenCV fallback is used otherwise)
Installation
pip install -r requirements.txt
Quick start
python app.py
Then open the generator:
http://localhost:5000/tools/image-to-360-spin-video
Usage
- Open the generator page.
- Upload a JPG, PNG, JPEG, or WEBP image.
- Choose whether to remove the background.
- Pick a solid HEX background color.
- Select a 360 rotation style.
- Generate the video.
- Preview and download the MP4.
Deployment
SpinForge AI runs on a VPS behind Nginx, or via Docker (recommended for reliable
FFmpeg/OpenCV system dependencies) and is Koyeb-ready. A typical production stack
uses Gunicorn + Nginx, HTTPS via Let’s Encrypt or Cloudflare, and writable
uploads/, outputs/, and data/ directories.
gunicorn app:app --config gunicorn.conf.py
Open source
SpinForge AI is released under the MIT License and developed in the open. Read the full guides in the SpinForge AI documentation, or contribute on GitHub.
Related Products
Flowline Automation
BetaVisual, YAML-backed automation for CI/CD, scheduled tasks, and internal tooling — no vendor lock-in.
View productForge AI Assistant
PreviewAn open, self-hostable AI assistant that plugs into your codebase, docs, and internal knowledge.
View product