mp_core #

Shared types, model configuration, and runtime primitives for MP tasks.

Use mp_core directly when building a custom task adapter, or transitively through mp_vision, mp_text, mp_audio, or mp_genai.

What it provides #

• Model assets, image and audio containers, result types, errors, and task lifecycle

• Immutable image, audio, landmark, classification, detection, embedding, and segmentation containers.
• Models loaded from bytes, local paths, or absolute URIs.
• Optional SHA-256 verification for remotely loaded models.
• CPU, GPU, Edge TPU NNAPI, and LiteRT delegate configuration.
• Task lifecycle, status errors, timestamp validation, and injectable runtimes.
• Generated FFI bindings for the public MediaPipe Tasks C headers.
• Shared browser module and model-asset helpers.

Model assets #

Models are application data, not SDK configuration. Supply one as bytes, a local path, or an absolute HTTPS URI, and pin remote models with a SHA-256 digest:

final local = ModelAsset.path('models/gesture_recognizer.task');
final memory = ModelAsset.bytes(Uint8List.fromList(modelBytes));
final remote = ModelAsset.uri(
  Uri.parse('https://cdn.example.com/models/gesture_recognizer.task'),
  sha256: '0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef',
);

The SDK never chooses or downloads a model without an explicit ModelAsset. Publish immutable, versioned model URLs and always provide a digest for production clients.

Combine a model with a delegate:

final options = BaseOptions(modelAsset: local, delegate: MpDelegate.cpu);

Ownership #

Every created task implements MpTask. Call close() when inference is no longer needed. Closing twice is safe, and invoking a closed task fails immediately with MpTaskClosedError.

final detector = await ObjectDetector.create(options);
try {
  final result = await detector.detect(image);
  // Use the result.
} finally {
  await detector.close();
}

Long-lived tasks belong near the owning feature boundary, not inside a per-frame callback. A task serializes its native calls, so handles are never entered concurrently.

Failure contract #

Unsupported API and platform combinations fail explicitly with MpException(MpStatus.unimplemented, …) rather than silently returning empty results. Check MpStatus before treating a failure as a model or input problem.

Where to go next #

• Package and API documentation
• Platform support matrix
• Guides
• Examples

MP is independent software. MediaPipe is a trademark of Google LLC; this project is not affiliated with or endorsed by Google.