tiomagic 0.1.0

A Python package for generating animations using AI-powered video models

Tio Magic Animation Toolkit

Tio Magic Animation Toolkit is designed to simplify the use of video AI models for animation. The Animation Toolkit empowers animators, developers, and AI enthusiasts to easily generate animated videos without the pain of complex technical setup, local hardware limitations, and haphazard documentation.

This toolkit leverages Modal for cloud computing and runs various open/closed-source video generation models.

Supported Features

Image to Video

Prompt: Woman smiling at the camera, waving her right hand as if she was saying hi and greeting someone.

Wan 2.1 Vace 14b	Framepack I2V HY	Wan 2.1 I2V FusionX (LoRA)
LTX Video	Pusa V1	Veo 2

Interpolate

Prompt: An anime-style young man in a blue t-shirt starts in a standing position. He lifts his right hand and waves to the camera.

Framepack I2V HY

Wan FLFV 14b

Wan 2.1 Vace 14b

Pose Guidance

Prompt: Anime-style cartoon animation of a man waving, empty white background. Skin tone, shading, lighting should be the same as the reference image.

Starting Image

Pose Video

Wan 2.1 Vace 14b

Text to Video

A playful cartoon-style penguin with a round belly and flappy wings waddles up to a pair of green sunglasses lying on the ground. The penguin leans forward, carefully picks up the sunglasses with its flipper, and smoothly lifts them up to its face. It tilts its head with a confident smile as the green sunglasses rest perfectly on its beak. The animation is smooth and expressive, with exaggerated, bouncy cartoon motion.

Wan 2.1 PhantomX (LoRA)

Pusa V1

Wan 2.1 14b

Usage

Go to Tio Magic Animation Toolkit Docs for detailed information on usage.

Environment Preparation

First, create a virtual environment and activate it.

python3 -m venv venv
source venv/bin/activate # on MacOS/Linux
venv/Scripts/activate # on Windows Command Prompt

Then, install Python packages:

pip install -e .

Then, create a .env file. Depending on what provider(s) you are using, copy/pase appropriate access keys to the .env file. For starters, we recommend registering for a Modal account and create an access token:

MODAL_TOKEN_ID=...
MODAL_TOKEN_SECRET=...

Create a Hugging Face account and add the token to your Modal account (this is needed to access open source models)

How to Run Modal Demo

python quick_start.py

Supported Providers and Models

Modal

Image to Video

• Cogvideox 5b I2V
• Framepack I2V HY
• LTX video
• Pusa V1
• Wan 2.1 I2V 14b 720p
• Wan 2.1 Vace 14b
• Wan 2.1 I2V FusionX (LoRA)

Interpolate

• Framepack I2V HY
• Wan 2.1 FLFV 14b
• Wan 2.1 Vace 14b

Pose Guidance

• Wan 2.1 Vace 14b

Text to Video

• Cogvideox 5b
• Pusa V1
• Wan 2.1 T2V FantomX (LoRA)
• Wan 2.1 14b
• Wan 2.1 Vace 14b
• Wan 2.1 PhantomX (LoRA)

Local

Image to Video

• Luma AI Ray 2
• Google Deepmind Veo 2

Interpolate

• Luma AI Ray 2