gradio_mmd_viewer 0.0.1

Gradio custom component: 3D MMD model viewer powered by Babylon.js + babylon-mmd

gradio_mmd_widget

[!WARNING] Unewviewed AI code Unewviewed AI code still remains.

A Gradio custom component for rendering MMD motion data in the browser with Babylon.js and babylon-mmd.

Why this component?

• Play VMD motion files with a built-in MMD character
• Use it directly as a Gradio input or output component
• Great for demos, interactive storytelling, and lightweight 3D previews

Installation

pip install gradio_mmd_viewer

Quick start

import gradio as gr
from gradio_mmd_viewer import MMDViewer

with gr.Blocks() as demo:
    gr.Markdown("## MMD Viewer")
    viewer = MMDViewer(
        value="asset/demo.vmd",
        label="MMD Viewer",
        scale=2,
        min_width=800,
    )

if __name__ == "__main__":
    demo.launch()

Features

• Built-in model and default motion assets
• Supports VMD URL input for switching animations
• Includes a local demo for development and testing

Demo

Run the bundled demo with:

python demo/app.py

Development notes

Technical implementation details, architecture notes, build steps, and troubleshooting guidance are maintained in AGENTS.md.