Skip to main content

Mimic Video

Project description

Mimic Video (wip)

Implementation of Mimic-Video, Video-Action Models for Generalizable Robot Control Beyond VLAs

Appreciation

  • Pranoy for submitting a pull request for proprioception masking

Install

$ pip install mimic-video

Usage

import torch

# video wrapper
# but will be agnostic to the model

from mimic_video.cosmos_predict import CosmosPredictWrapper

video_wrapper = CosmosPredictWrapper(
    extract_layer = 1,
    random_weights = True,
    tiny = True
)

# mimic video

from mimic_video import MimicVideo

model = MimicVideo(512, video_wrapper)

# states

video = torch.rand(2, 3, 3, 32, 32)

joint_state = torch.randn(2, 32)

# action

actions = torch.randn(2, 32, 20)

# training

loss = model(
    prompts = [
        'put the package on the conveyer belt',
        'pass the butter'
    ],
    video = video,
    actions = actions,
    joint_state = joint_state
)

loss.backward()

# inference

actions = model.sample(
    prompts = 'peel the orange',
    video = video[:1],
    joint_state = joint_state[:1]
)

assert actions.shape == (1, 32, 20)

Contributing

First make sure pytest and test dependencies are installed with

$ pip install '.[test]'

Then add your test to tests/test_mimic_video.py and run

$ pytest tests

That's it

Citations

@inproceedings{Pai2025mimicvideoVM,
    title   = {mimic-video: Video-Action Models for Generalizable Robot Control Beyond VLAs},
    author  = {Jonas Pai and Liam Achenbach and Victoriano Montesinos and Benedek Forrai and Oier Mees and Elvis Nava},
    year    = {2025},
    url     = {https://api.semanticscholar.org/CorpusID:283920528}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mimic_video-0.0.19.tar.gz (778.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mimic_video-0.0.19-py3-none-any.whl (10.7 kB view details)

Uploaded Python 3

File details

Details for the file mimic_video-0.0.19.tar.gz.

File metadata

  • Download URL: mimic_video-0.0.19.tar.gz
  • Upload date:
  • Size: 778.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for mimic_video-0.0.19.tar.gz
Algorithm Hash digest
SHA256 7beb0eea131e66b7ac1e3a28822e7793827347c92d18e2610f91b14b2907e5de
MD5 c56bc8e2ef59aaed77202018e08478d6
BLAKE2b-256 baaa725c83e11bbaad41c718a7c83c7c71c00d5626f54a455d70dfa8a5d0e720

See more details on using hashes here.

File details

Details for the file mimic_video-0.0.19-py3-none-any.whl.

File metadata

  • Download URL: mimic_video-0.0.19-py3-none-any.whl
  • Upload date:
  • Size: 10.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for mimic_video-0.0.19-py3-none-any.whl
Algorithm Hash digest
SHA256 fb8abf9f0c9003062d574d06ec3d3817e59ee3de6a8df995a4c1aa45b7996560
MD5 6f68796108e38d757c553b7f136f0939
BLAKE2b-256 fda8eceaf55e64648d01f5563040a1790608fe79a522f9c1ed165e1b6a8d01cd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page