Skip to main content

google_ml_kit 1.0.2 copy "google_ml_kit: ^1.0.2" to clipboard
google_ml_kit: ^1.0.2 copied to clipboard

A Flutter plugin to use all APIs from Google's standalone ML Kit for mobile platforms.

Google's ML Kit for Flutter #

Pub Version analysis Star on GitHub License: MIT

Google's ML Kit for Flutter is a set of Flutter plugins that enable Flutter apps to use Google's standalone ML Kit.

google_ml_kit is an umbrella plugin that groups the Vision, Natural Language, and GenAI plugins under a single package (google_mlkit_document_scanner and google_mlkit_subject_segmentation are standalone packages and must be added individually). By using google_ml_kit you will include all of its exported plugins and their respective dependencies, significantly increasing the size of your app. We recommend adding only the specific plugin(s) for the feature(s) you need rather than depending on google_ml_kit.

DO NOT USE google_ml_kit in a production app; instead, depend directly on the individual plugin package(s) listed below.

Go to each plugin listed below to read about their documentation and requirements. If you find issues report and contribute with your pull requests.

Features #

Vision APIs #

Feature Plugin Android iOS
Barcode Scanning google_mlkit_barcode_scanning Pub Version ✅ ✅
Face Detection google_mlkit_face_detection Pub Version ✅ ✅
Face Mesh Detection (Beta) google_mlkit_face_mesh_detection Pub Version ✅ ❌
Text Recognition v2 google_mlkit_text_recognition Pub Version ✅ ✅
Image Labeling google_mlkit_image_labeling Pub Version ✅ ✅
Object Detection and Tracking google_mlkit_object_detection Pub Version ✅ ✅
Digital Ink Recognition google_mlkit_digital_ink_recognition Pub Version ✅ ✅
Pose Detection (Beta) google_mlkit_pose_detection Pub Version ✅ ✅
Selfie Segmentation (Beta) google_mlkit_selfie_segmentation Pub Version ✅ ✅
Subject Segmentation (Beta) google_mlkit_subject_segmentation Pub Version ✅ ❌
Document Scanner (Beta) google_mlkit_document_scanner Pub Version ✅ ❌

Natural Language APIs #

Feature Plugin Android iOS
Language Identification google_mlkit_language_id Pub Version ✅ ✅
On-Device Translation google_mlkit_translation Pub Version ✅ ✅
Smart Reply google_mlkit_smart_reply Pub Version ✅ ✅
Entity Extraction (Beta) google_mlkit_entity_extraction Pub Version ✅ ✅

GenAI APIs #

⚠️ Important: GenAI APIs are built on top of AICore and will not support all Android devices. These APIs require devices with AICore support. Please check device compatibility before using these features in production.

⚠️ Production Disclaimer: Using GenAI plugins in production is the responsibility of the developers consuming the plugins, not the authors. The authors provide these plugins as-is and are not responsible for any issues, failures, or compatibility problems that may arise from using these plugins in production environments.

Feature Plugin Android iOS
Summarization (Beta) google_mlkit_genai_summarization Pub Version ✅ ❌
Proofreading (Beta) google_mlkit_genai_proofreading Pub Version ✅ ❌
Rewriting (Beta) google_mlkit_genai_rewriting Pub Version ✅ ❌
Image Description (Beta) google_mlkit_genai_image_description Pub Version ✅ ❌
Speech Recognition (Alpha) google_mlkit_genai_speech_recognition Pub Version ✅ ❌
Prompt (Alpha) google_mlkit_genai_prompt Pub Version ✅ ❌

Common APIs #

Feature Plugin Android iOS
Shared types (InputImage, ModelManager) google_mlkit_commons Pub Version ✅ ✅

PLEASE READ THIS before continuing or posting a new issue:

  • Google's ML Kit was built only for mobile platforms: iOS and Android apps. Web or any other platform is not supported, you can request support for those platforms to Google in their repo.

  • This plugin is not sponsored or maintained by Google. The authors are developers excited about Machine Learning that wanted to expose Google's native APIs to Flutter.

  • Google's ML Kit APIs are only developed natively for iOS and Android. This plugin uses Flutter Platform Channels as explained here.

    Messages are passed between the client (the app/plugin) and host (platform) using platform channels as illustrated in this diagram:

    Messages and responses are passed asynchronously, to ensure the user interface remains responsive. To read more about platform channels go here.

    Because this plugin uses platform channels, no Machine Learning processing is done in Flutter/Dart, all the calls are passed to the native platform using MethodChannel in Android and FlutterMethodChannel in iOS, and executed using Google's native APIs. Think of this plugin as a bridge between your app and Google's native ML Kit APIs. This plugin only passes the call to the native API and the processing is done by Google's API. It is important that you understand this concept when it comes to debugging errors for your ML model and/or app.

  • Since the plugin uses platform channels, you may encounter issues with the native API. Before submitting a new issue, identify the source of the issue. You can run both iOS and/or Android native example apps by Google and make sure that the issue is not reproducible with their native examples. If you can reproduce the issue in their apps then report the issue to Google. The authors do not have access to the source code of their native APIs, so you need to report the issue to them. If you find that their example apps are okay and still you have an issue using this plugin, then look at our closed and open issues. If you cannot find anything that can help you then report the issue and provide enough details. Be patient, someone from the community will eventually help you.

Requirements #

iOS #

  • Minimum iOS Deployment Target: 15.0
  • Xcode 15.3.0 or newer
  • Swift 5.9 (Swift Package Manager)
  • ML Kit does not support 32-bit architectures (i386 and armv7). ML Kit does support 64-bit architectures (x86_64 and arm64). Check this list to see if your device has the required device capabilities. More info here.

Swift Package Manager Setup

All ML Kit iOS plugins use Swift Package Manager (SwiftPM) via d-date/google-mlkit-swiftpm (9.0.2), which also supports Apple Silicon iOS Simulators out of the box.

  1. Linker Flags: In Xcode, go to Runner > Build Settings > Linking - General > Other Linker Flags (OTHER_LDFLAGS) and add:

    • -ObjC
    • -all_load
  2. ML Kit Resource Bundles: SwiftPM cannot bundle model files inside .binaryTarget frameworks into the main app bundle automatically. Download the required .bundle archives from the d-date/google-mlkit-swiftpm v9.0.2 release and add them to your Xcode Runner target (Build Phases > Copy Bundle Resources). See packages/example/ios/download_mlkit_bundles.sh for a ready-to-use download script.

Android #

  • minSdkVersion: 21 (24 for google_mlkit_subject_segmentation, 26 for google_mlkit_genai_*)
  • targetSdkVersion: 36
  • compileSdkVersion: 36

⚠️ Production Disclaimer: Using these plugins in production is the responsibility of the developers consuming the plugins, not the authors. The authors provide these plugins as-is and are not responsible for any issues, failures, or compatibility problems that may arise from using these plugins in production environments.

Migrating from ML Kit for Firebase to the new standalone ML Kit SDK #

When migrating from ML Kit for Firebase to the new standalone ML Kit SDK read this guide.

For Android details read this.

For iOS details read this.

Example app #

Find the example app here.

Consuming image streams on Android #

Until flutter/flutter#145961 is resolved, the default CameraX implementation in the camera package doesn't support the required nv21 image format. To use camera image streams on Android, manually add camera_android to your app's pubspec.yaml.

Contributing #

Contributions are welcome. In case of any problems look at existing issues, if you cannot find anything related to your problem then open an issue. Create an issue before opening a pull request for non-trivial fixes. In case of trivial fixes open a pull request directly.