whatisgithub

What is hy-motion-1.0?

tencent-hunyuan/hy-motion-1.0 — explained in plain English

Analysis updated 2026-05-18

2,341PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A Tencent AI model that generates 3D human motion animations for humanoid characters from plain English text descriptions of physical actions.

Mindmap

mindmap
  root((HY-Motion 1.0))
    What it does
      Text to 3D motion
      Humanoid animation
      Diffusion Transformer
    Tech stack
      Python
      Gradio
      Hugging Face
    Use cases
      Batch generation
      Interactive preview
      Animation pipelines
    Audience
      Researchers
      Animators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a humanoid animation clip from a text prompt describing an action.

USE CASE 2

Batch-generate many motion clips from a list of prompts via the command line.

USE CASE 3

Preview generated motions through the Gradio web interface.

USE CASE 4

Import generated skeleton animations into a 3D animation pipeline.

What is it built with?

PythonGradioHugging Face

How does it compare?

tencent-hunyuan/hy-motion-1.0nv-tlabs/kimodoideogram-oss/ideogram4
Stars2,3412,3502,406
LanguagePythonPythonPython
Last pushed2026-06-30
MaintenanceActive
Setup difficultyhardhardmoderate
Complexity5/55/53/5
Audienceresearcherresearcherdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires at least 24GB of GPU VRAM, humanoid characters only, no animals or multi-person scenes.

So what is it?

HY-Motion 1.0 is an AI model from Tencent that generates 3D human motion animations from text descriptions. You describe an action in plain English, for example, "a person performs a squat, then pushes a barbell overhead", and the model produces a sequence of skeleton poses representing that movement. The output can be imported directly into 3D animation workflows. The model uses a technique called Diffusion Transformer (DiT) combined with Flow Matching, which is a method for generating high-quality outputs by gradually refining a noisy signal. It is trained in three stages: first on over 3,000 hours of diverse motion capture data, then fine-tuned on 400 hours of curated high-quality recordings, then further refined using reinforcement learning from human feedback. Two model sizes are available, a standard 1-billion-parameter version and a lighter 0.46-billion-parameter version. Both require at least 24 GB of GPU video memory (VRAM) to run locally. The generated animations work with humanoid characters only, it does not support animals, multi-person interactions, or environment-dependent movements. Prompts work best in English and should focus on physical actions and limb movements rather than emotions, clothing, or camera angles. You can run it from the command line for batch processing of many prompts, or through an interactive browser-based interface built with Gradio. Model weights are downloaded separately from Hugging Face. It is written in Python and released by Tencent's Hunyuan research team. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Set up HY-Motion 1.0 and generate a clip from 'a person performs a squat then pushes a barbell overhead'.
Prompt 2
Explain the GPU requirements for running HY-Motion 1.0 locally.
Prompt 3
Use HY-Motion 1.0's Gradio interface to preview a generated animation.
Prompt 4
What's the difference between the 1B and 0.46B HY-Motion models?

Frequently asked questions

What is hy-motion-1.0?

A Tencent AI model that generates 3D human motion animations for humanoid characters from plain English text descriptions of physical actions.

What language is hy-motion-1.0 written in?

Mainly Python. The stack also includes Python, Gradio, Hugging Face.

How hard is hy-motion-1.0 to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is hy-motion-1.0 for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.