跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

litert-compiled-model-migration

Rapidly migrate an Android application from legacy TensorFlow Lite (TFLite) to modern LiteRT CompiledModel API v2.1.6 in Open Source GitHub repositories. Supports True Async Execution (runAsync), Zero-Copy I/O Buffers, NPU JIT compilation, and automated 2-stage verification self-testing.

google-ai-edge · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add google-ai-edge/litert-samples --skill litert-compiled-model-migration

技能说明


name: litert-compiled-model-migration description: Rapidly migrate an Android application from legacy TensorFlow Lite (TFLite) to modern LiteRT CompiledModel API v2.1.6 in Open Source GitHub repositories. Supports True Async Execution (runAsync), Zero-Copy I/O Buffers, NPU JIT compilation, and automated 2-stage verification self-testing.

Skill: LiteRT Compiled Model Migration SKILL

Description

This skill guides an AI agent to rapidly migrate an Android application from legacy TensorFlow Lite (TFLite) to the modern LiteRT CompiledModel API v2.1.6 in Open Source GitHub repositories. It prioritizes a high-speed, 1st-pass "Like for Like" baseline migration with automated self-testing, and encourages advanced performance upgrades including True Asynchronous Execution (runAsync), Zero-Copy I/O Buffer Management, and NPU JIT compilation.


0. Automatic Discovery & Upfront Planning

Before writing code, the agent MUST inspect the project workspace and present the upfront planning interview to align migration parameters:

A. Automatic Workspace & Toolchain Discovery

The agent must automatically inspect the repository structure:

  1. Ecosystem & Build Engine:
    • Gradle Build System: Detected by build.gradle, build.gradle.kts, or settings.gradle. -> Enable Gradle & GitHub PR Workflow.
  2. Language & JNI Toolchain:
    • Native C++ / NDK: Detected if CMakeLists.txt, Android.mk, or *.cpp files exist. -> Enable C++ / JNI Migration Rules.
    • Pure Kotlin / Java: Default to JVM / Android SDK Migration Rules.

[!TIP] Speed Optimization (Subagent Routing): When orchestrating subagents, the agent MUST default to DeepCoderLite (or DeepInvestigatorLite) to guarantee a 2–5 minute migration turnaround. Do NOT invoke heavy multi-layer DeepCoder synthesis unless the codebase features complex custom C++ NDK/CMake build systems.

B. Upfront User Interview (Questions Asked Prior to Migration)

The agent must present the following review options to the user:

Before initiating the LiteRT Compiled Model Migration, please confirm your project preferences:

1. Model Workload & Domain:
   What type of data does this application process?
   - [A] Vision (Images / Video / Camera Feeds) -> Enables Zero-Copy AHardwareBuffer / direct ByteBuffer recipes.
   - [B] Audio (Speech / Sound Classification) -> Enables streaming FloatArray or ByteBuffer recipes.
   - [C] Text / NLP / GenAI -> Enables tokenized tensor buffer recipes.

2. LiteRT Runtime Target SDK:
   Which SDK distribution target should the project use?
   - [A] Standalone / Bundled LiteRT V2 (com.google.ai.edge.litert:litert) [Default]
         -> Bundles LiteRT runtime inside the APK for offline self-contained operation.
   - [B] LiteRT-in-GMSCore (com.google.android.gms:play-services-litert) [Experimental / Future Release]
         -> Dynamically requests runtime from Google Play Services, saving ~5 MB APK binary bloat.

3. Hardware Acceleration & Conditional INT8 Quantization:
   Do you want to enable NPU hardware acceleration via JIT on-device compilation?
   - [A] Yes (Recommended - replaces deprecated NNAPI) [Default]
         * If the app uses a Float32 model: Would you like to generate an INT8 integer-quantized model via AI Edge Quantizer for peak NPU speed, or run the original Float32 model?
           -> Option A.1: Convert to INT8 (Generates model_int8.tflite for NPU matrix engines) [Default]
           -> Option A.2: Keep Float32 (Runs baseline float model directly on NPU)
   - [B] No (GPU and CPU acceleration only)

4. Encouraged Performance Upgrades:
   Should the agent upgrade the calling code to use LiteRT's advanced features?
   - [A] Yes (Enable True Async Execution runAsync & Zero-Copy I/O Buffers) [Default]
   - [B] No (Keep strict 1-to-1 synchronous baseline execution)

5. Automated Pull Request Provisioning:
   Should the agent automatically stage, commit, and create a GitHub PR when self-testing passes?
   - [A] Yes [Default] (Attaches verification test logs and before/after summary diff)
   - [B] No (Keep changes local in current working branch)

[!IMPORTANT] Mandatory Support Library Removal: The agent must inform the user that all legacy org.tensorflow.lite.support libraries (ImageProcessor, ResizeOp, NormalizeOp, etc.) will be completely removed and replaced with direct LiteRT buffer APIs and native preprocessing. This is mandatory to unlock zero-copy speed and API compatibility.


1. Phase 1: "Like for Like" Baseline Migration (1st Pass Success)

Phase 1 prioritizes functional equivalence, fast compilation, and immediate 1st pass self-test success.

Step 1: Clean & Modernize Dependencies

Inspect libs.versions.toml and build.gradle.kts:

  • Remove Legacy & Deprecated:
    • org.tensorflow:tensorflow-lite
    • org.tensorflow:tensorflow-lite-gpu
    • org.tensorflow:tensorflow-lite-support
    • org.tensorflow:tensorflow-lite-select-tf-ops (Legacy Flex Delegate — see Deprecated API Remediation below)
  • Replace TFLite Support Image Preprocessing: If the application uses legacy TFLite Support (org.tensorflow.lite.support.image.ImageProcessor, ResizeOp, NormalizeOp), completely remove the Support library dependency. Replace image scaling with androidx.core.graphics.scale (or Bitmap.createScaledBitmap) and replace normalization with direct memory-mapped pixel buffer writing (ByteBuffer.allocateDirect / AHardwareBuffer).
  • Add Modern LiteRT:
    • Standalone: implementation 'com.google.ai.edge.litert:litert:2.1.6'
    • GMSCore: implementation 'com.google.android.gms:play-services-litert:16.0.0'
  • IDE Portability: Remove hardcoded org.gradle.java.home from gradle.properties and exclude local.properties.
  • Kotlin Compiler DSL: Use top-level kotlin { compilerOptions { ... } } outside android { ... }.

Step 2: Deprecated API & Delegate Reme

阅读完整来源 ↗