Download MediaPipe Model Files

If your MediaPipe app fails at startup with a 404 or a network error on modelAssetPath, you are in the right place. This page lists the direct download URLs for the MediaPipe model files, what each one contains, and what to do when Google Cloud Storage is unreachable from your network.

Direct Download Links#

These are the official URLs on Google Cloud Storage. Sizes were checked on 15 November 2026.

Face Landmarker: https://storage.googleapis.com/mediapipe-models/face_landmarker/face_landmarker/float16/latest/face_landmarker.task

Hand Landmarker: https://storage.googleapis.com/mediapipe-models/hand_landmarker/hand_landmarker/float16/latest/hand_landmarker.task

What float16 and the Version Number Mean#

The model URLs follow a fixed pattern: storage.googleapis.com/mediapipe-models/<task>/<model>/<precision>/<version>/<file>.task. Two parts of that path trip people up.

• float16 is the quantized model, which is the one Google publishes for web and the one every official example loads. It is roughly half the size of full precision with no accuracy difference you will notice in a browser.
• latest or 1 is the version segment. As of 15 November 2026 both paths return byte-identical files, so the /1/ URLs copied from older tutorials still work. Prefer /latest/ in new code so you pick up model updates.

Loading the Model in JavaScript#

You do not have to download the file at all. The MediaPipe Tasks API fetches it for you when you pass the URL as modelAssetPath.

Downloading the file makes sense when you want to self-host it, pin a known version, or ship it inside an offline build. Drop it in your public/ folder and point modelAssetPath at the local path instead.

If storage.googleapis.com Is Blocked#

In some regions and on some corporate networks the Google Cloud Storage domain is blocked or unreliable, so the model fails to load at runtime even though your code is correct. I mirror the two files I use most in a GitHub release so they stay reachable.

Or point modelAssetPath straight at the mirror:

The mirror was last refreshed in May 2026. It carries only the face and hand models. For anything else, use the official URLs above.

Troubleshooting#

The model loads locally but 404s in production#

Check that your host serves .task files. Some static hosts only serve an allowlist of extensions and silently return the index page instead, which the loader then fails to parse.

CORS errors when self-hosting#

The file has to be served with Access-Control-Allow-Origin if it sits on a different origin from your page. Serving it from the same origin as the app avoids the problem entirely.

The download is slow or stalls on first load#

These files are several megabytes and are fetched before the first frame can be processed. Show a loading state while the model initializes, and cache it with a service worker if users return often.

License#

MediaPipe is open source under the Apache 2.0 license. The mirrored files are redistributed unmodified with the original license and attribution intact.

Related#

Once the model loads, you will want all 478 face landmark indices grouped by face region, or the step-by-step hand and face tracking tutorial that builds a working app around these files.