CoolFace
Apppublic

bandrik0/manim

sourceHugging Faceupdated 1y agoView on Hugging Face
1likes
App README

Bu proje, Manim tabanlı bir logo oluşturma web uygulamasıdır.

🎬 Manim Logo Renderer WebApp

Create beautiful animated logo videos in seconds using Manim! Upload your logo (SVG/PNG), pick an animation, and download your MP4 — all in your browser.

✨ Features

  • —Multiple Animations: draw (SVG outline tracing), fade, spin, bounce
  • —Customizable: Set background color, animation duration, and video quality
  • —Instant Preview: Drag & drop logo, see animation options, download result
  • —Simple Stack: FastAPI backend (Python), minimal HTML/JS frontend
  • —Docker-ready: 1-click deploy to Hugging Face Spaces or run locally

📂 Project Structure

.
├── backend/
│   ├── app.py            # FastAPI app: POST /render, GET /health, serves /web
│   ├── renderer.py       # Manim scene generator + CLI render
│   ├── requirements.txt  # Python dependencies for backend + Manim
├── frontend/
│   └── index.html        # Drag & drop UI
├── Dockerfile            # Root-level, for Hugging Face Spaces & Docker
├── .gitignore
└── README.md

🚀 Local Setup

Requirements:

  • —Python 3.11+
  • —ffmpeg (if not using Docker)
  • —On Apple Silicon (macOS M1/M2), Manim is easiest via conda-forge (see Troubleshooting below)

1. Create a virtual environment & install dependencies

bash
python3 -m venv .venv
source .venv/bin/activate    # On Windows: .venv\Scripts\activate
pip install --upgrade pip
pip install -r backend/requirements.txt

2. Run the backend server

bash
uvicorn app:app --app-dir backend --host 127.0.0.1 --port 8000 --reload

3. Open the web UI

Just open frontend/index.html in your browser.

Health check: http://127.0.0.1:8000/health → returns {"ok": true}

🐳 Deploy on Hugging Face Spaces (or Docker)

  1. 1.On Hugging Face Spaces:
  2. 2.Click "Create Space", choose Docker as the SDK, and point to this repo.
  3. 3.The included Dockerfile handles all dependencies.
  1. 1.With Docker locally:
bash
   docker build -t manim-logo-webapp .
   docker run -p 8000:8000 manim-logo-webapp

Then open frontend/index.html and use as above.

🛠️ Troubleshooting / Notes

  • —Apple Silicon (M1/M2): Manim works best via conda.
bash
  brew install miniforge
  conda create -n manim python=3.11
  conda activate manim
  pip install -r backend/requirements.txt
  • —SVGs: For best results, use simple SVG logos (single path or group).
  • —Security: The backend does not persist uploads or output files.

📦 Dependencies

All backend Python dependencies are listed in backend/requirements.txt.

📝 License

MIT License — see LICENSE.

🙏 Credits