Skip to main content

google_mlkit_genai_prompt 0.4.2 copy "google_mlkit_genai_prompt: ^0.4.2" to clipboard
google_mlkit_genai_prompt: ^0.4.2 copied to clipboard

A Flutter plugin to use Google's ML Kit GenAI Prompt API to send custom requests to Gemini Nano.

Google's ML Kit GenAI Prompt for Flutter #

Pub Version analysis Star on GitHub License: MIT

NOTE: This feature is still in Alpha, and it is only available for Android. Stay tuned for updates on Google's website and request the feature here.

A Flutter plugin to use Google's ML Kit GenAI Prompt API to generate text content based on custom prompts.

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 #

This feature is still in Alpha, and it is only available for Android. Stay tuned for updates on Google's website and request the feature here.

Android #

  • minSdkVersion: 26
  • targetSdkVersion: 36
  • compileSdkVersion: 36

⚠️ Important: This API is built on top of AICore and will not support all Android devices. It requires devices with AICore support. Please check device compatibility before using this feature in production.

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

Usage #

Prompt #

Create an instance of Prompt

final prompt = Prompt();

Check feature status

final status = await prompt.checkFeatureStatus();
if (status == FeatureStatus.downloadable) {
  await prompt.downloadFeature();
} else if (status == FeatureStatus.available) {
  // Start prompt generation
}

Generate text from prompt

final text = "Write a 3 sentence story about a magical dog.";
final response = await prompt.runInference(text);
print('Response: $response');

Generate text from multimodal prompt (image + text)

// From a file path:
final imageData = {
  'type': 'file',
  'path': '/path/to/image.jpg',
};
// Or from encoded image bytes (Uint8List):
// final imageData = {'type': 'bytes', 'bytes': uint8List};
// Or from an InputImage (from google_mlkit_commons):
// final imageData = inputImage.toJson();

final text = "What's in this image?";
final response = await prompt.runInference(text, imageData: imageData);
print('Response: $response');

⚠️ Implementation Status: On Android, checkFeatureStatus(), downloadFeature(), and close() are currently wired to the native Generation.getClient() API, while runInference() and runInferenceStreaming() are still work-in-progress and currently return a platform error (PromptError / notImplemented).

Release resources with close()

prompt.close();

Example app #

Find the example app here. Note that the GenAI screens in the example app are currently placeholder views.

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.

0
likes
160
points
1.21k
downloads

Documentation

API reference

Publisher

verified publisherflutter-ml.dev

Weekly Downloads

A Flutter plugin to use Google's ML Kit GenAI Prompt API to send custom requests to Gemini Nano.

Homepage
Repository (GitHub)
View/report issues

License

MIT (license)

Dependencies

flutter, google_mlkit_commons

More

Packages that depend on google_mlkit_genai_prompt

Packages that implement google_mlkit_genai_prompt