Metadata-Version: 2.4
Name: gradio_mmd_viewer
Version: 0.0.6
Summary: Gradio custom component: 3D MMD model viewer powered by Babylon.js + babylon-mmd
Project-URL: repository, https://github.com/Winterreisender/gradio-mmd-viewer
Author-email: Winterreisender <winterreisender@foxmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: 3d-viewer,babylonjs,gradio-custom-component,miku-miku-dance,mmd
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.13
Requires-Dist: gradio<7.0,>=6.0
Requires-Dist: uvicorn>=0.51.0
Requires-Dist: websockets>=16.1
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Description-Content-Type: text/markdown

﻿# 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

```bash
pip install gradio_mmd_viewer
```

## Quick start

```python
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:

```bash
python demo/app.py
```

## Development notes

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