whatisgithub

What is animateddrawings?

facebookresearch/animateddrawings — explained in plain English

Analysis updated 2026-06-24

12,798PythonAudience · researcherComplexity · 3/5Setup · hard

In one sentence

A Python tool from Meta AI Research that takes a photo of a hand-drawn humanoid character, detects its body parts with machine learning, and animates it with real human motion data to produce MP4 or GIF output.

Mindmap

mindmap
  root((repo))
    What it does
      Animate hand-drawn figures
      AI body detection
      Motion mapping
    Inputs
      Drawing image file
      Motion config file
    Outputs
      MP4 video
      Transparent GIF
    Tech Stack
      Python
      Docker container
      ML detection model
Click or tap to explore — scroll the page freely

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

Turn a child's hand-drawn stick figure into a walking or dancing animation exported as an MP4 video

USE CASE 2

Research automatic animation techniques for sketched humanoid characters without manual rigging

What is it built with?

PythonDockerMachine Learning

How does it compare?

facebookresearch/animateddrawingsdatalux/osintgramjacobgil/pytorch-grad-cam
Stars12,79812,80012,802
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity3/52/53/5
Audienceresearcherresearcherresearcher

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Docker or macOS with Apple Silicon, repository is archived and no longer maintained, no further bug fixes.

So what is it?

Animated Drawings is a Python tool from Meta AI Research that brings hand-drawn characters to life. You give it an image of a drawn human figure, and it produces an animation where that character moves, walks, dances, or performs whatever motion you choose. The project was built to accompany an academic paper about animating children's drawings, but it works on any sketch of a humanoid shape. The tool works in two stages. First, a machine learning model detects the character in your drawing, figures out where its body parts are (head, arms, legs), and automatically creates the internal structure needed to animate it. Second, the animation engine maps motion data from real human actors onto that structure and renders the result. You can export the output as an MP4 video, a transparent GIF, or view it in an interactive window where you can pause, step through frames, and replay. Setting it up requires Python and either Docker (to run the detection models in a container) or a local macOS setup with Apple Silicon. The animation behavior is controlled by configuration files, so you can change which motion is applied, adjust timing, and combine multiple characters in a scene without writing code. The repository has been archived by its creator, who is no longer maintaining it. The core functionality still works, but there will be no further updates or bug fixes. If you want to try it, the installation instructions are written for macOS and Ubuntu.

Copy-paste prompts

Prompt 1
I have a PNG of a hand-drawn stick figure, walk me through using Animated Drawings to detect the body parts and export a walking animation as an MP4
Prompt 2
Show me how to swap the motion config file in Animated Drawings to make my drawn character dance instead of walk
Prompt 3
Set up Animated Drawings on macOS with Apple Silicon using the local install path instead of Docker, and run the demo on a test image

Frequently asked questions

What is animateddrawings?

A Python tool from Meta AI Research that takes a photo of a hand-drawn humanoid character, detects its body parts with machine learning, and animates it with real human motion data to produce MP4 or GIF output.

What language is animateddrawings written in?

Mainly Python. The stack also includes Python, Docker, Machine Learning.

How hard is animateddrawings to set up?

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

Who is animateddrawings for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.