Skip to main content

mlx-video

mlx-video is a small video preprocessing library for MLX on Apple Silicon.

GitHub: https://github.com/AmiraniLabs/mlx-video

It focuses on the first mile of video ML:

  • load video files into mlx.core.array
  • sample frames at a target FPS
  • resize clips for model input
  • convert uint8 frames to normalized float32 tensors

Install

pip install mlx-video

Publishing

This package is configured for PyPI Trusted Publishing from the AmiraniLabs/mlx-video GitHub repository using .github/workflows/publish.yml.

Quickstart

import mlx_video as mv

frames = mv.load("video.mp4", fps=8)         # mx.array [T, H, W, C], uint8 RGB
frames = mv.resize(frames, (224, 224))       # spatial resize
frames = mv.normalize(frames)                # float32, ImageNet normalized

API

load(path, fps=None, start_time=None, end_time=None, max_frames=None)

Loads a video into a mx.array with shape [T, H, W, C] in RGB order.

resize(frames, size)

Resizes each frame to (height, width).

to_float(frames, scale=True)

Casts frames to float32. By default values are scaled to [0, 1].

normalize(frames, mean=..., std=...)

Applies channel-wise normalization using ImageNet defaults. Integer inputs are automatically converted to floating point and scaled before normalization.

Metadata

Release files for mlx-video 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mlx-video 0.1.0
File Size Uploaded Provenance Actions
mlx_video-0.1.0.tar.gz 5.3 kB With provenance Details for mlx_video-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mlx-video 0.1.0
File Interpreter ABI Platform Actions
mlx_video-0.1.0-py3-none-any.whl Python 3 none any Details for mlx_video-0.1.0-py3-none-any.whl

Total release size: 10.4 kB

Release files / mlx_video-0.1.0.tar.gz

Download URL mlx_video-0.1.0.tar.gz
Size 5.3 kB
Tags Source
SHA-256 checksum
How to use checksums
4c5059701cec1db33700dbbb1d63ac2b95edad73974a504ffde28b2b2c396639
BLAKE2b-256 checksum
How to use checksums
c8f0fbb9393abb8d52f22f52f148f2c28f62cafee11f708459254d5afb71f080
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 15, 2026.

Transparency log

Release files / mlx_video-0.1.0-py3-none-any.whl

Download URL mlx_video-0.1.0-py3-none-any.whl
Size 5.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
21f2dffd22654c8818896bd66b31c536769db0e67b1e1ec68fd1be2836e37588
BLAKE2b-256 checksum
How to use checksums
0e9a00fdfeb48a24e3a046e55ffae7b4bc1d1cd5d53cccfbc354af103cb9fdcd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 15, 2026.

Transparency log

Security for mlx-video 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mlx_video-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page