README.md

---
title: Text2Motion Prompter
emoji: 🎬
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 5.9.1
app_file: app.py
pinned: false
short_description: Transform action descriptions into structured motion prompts
license: mit
tags:
  - motion-generation
  - text-to-motion
  - animation
  - 3d-motion
---

# 🎬 Text2Motion Prompter

Transform action descriptions into structured motion prompts for 3D animation systems.

## Features

- **Duration Estimation**: Analyzes action complexity to estimate execution time in frames (30fps)
- **Caption Refinement**: Generates refined, grammatically correct English descriptions
- **Multi-language Support**: Accepts inputs in multiple languages (English, Chinese, etc.)
- **ZeroGPU Powered**: Utilizes Hugging Face's ZeroGPU for efficient inference

## Usage

1. Enter an action description in the input field (e.g., "walking forward", "跳跃")
2. Adjust the max tokens if needed
3. Click "Generate Motion Prompt"
4. Get a structured JSON response with duration and refined caption

## Output Format

```json
{
    "duration": 90,
    "short_caption": "A person walks forward at a steady pace."
}
```

## Model

This Space uses the [Text2MotionPrompter](https://huggingface.co/Text2MotionPrompter/Text2MotionPrompter) model.

## License

MIT License