Skip to content

Supported Devices and AICore Errors

Puzzak edited this page Nov 20, 2026 · 1 revision

Supported Devices & AICore Error Taxonomy

PAIOS executes Gemini Nano locally on your device's NPU/TPU through Android AICore (com.google.android.aicore) and ML Kit GenAI (com.google.mlkit:genai-prompt:1.0.0-beta5).


Qualified Hardware & Device Matrix

Device Family Verified Models Hardware Accelerator Minimum OS AICore Status
Google Pixel 9 / 10 Pixel 9, 9 Pro, 9 Pro XL, 9 Pro Fold, Pixel 10 series Google Tensor G4+ (EdgeTPU) Android 14 (API 34) Full Production (Multimodal Gemini Nano)
Google Pixel 8 Pixel 8 Pro Google Tensor G3 (EdgeTPU) Android 14 (API 34) Full Production (Preloaded / On-Demand)
Google Pixel 8 Pixel 8, Pixel 8a Google Tensor G3 (EdgeTPU) Android 14 (API 34) Supported via AICore Developer Options
Samsung Galaxy S24 Galaxy S24, S24+, S24 Ultra Snapdragon 8 Gen 3 / Exynos 2400 Android 14 (One UI 6.1) Production Rollout
Samsung Galaxy Z6 Galaxy Z Fold6, Z Flip6 Snapdragon 8 Gen 3 for Galaxy Android 14 (One UI 6.1.1) Production Rollout
Samsung Galaxy S25 Galaxy S25, S25+, S25 Ultra Snapdragon 8 Elite / Exynos 2500 Android 15 (One UI 7.0) Full Production
Xiaomi / Motorola / OEMs Xiaomi 14T Pro, Xiaomi 15, Motorola Razr 50 Ultra / Razr+ (2024), Android 15+ flagships Snapdragon 8 Gen 3/4/Elite, Dimensity 9300+ Android 14 / 15+ Early Access / OEM Firmware Dependent

System Prerequisites Checklist

  1. Android 14+ (minSdk = 34): With Google Play System Update (Project Mainline) dated December 2023 or newer (Android 15+ recommended).
  2. 8 GB+ RAM: Minimum 8 GB physical RAM (12 GB+ recommended for multimodal inference without background eviction).
  3. Locked Bootloader: Google AICore disables on-device Gemini Nano on devices with an unlocked bootloader (typically surfacing 606 - FEATURE_NOT_FOUND).
  4. Android AICore Installed & Updated: com.google.android.aicore active from Google Play Store (AICore listing).
  5. Free Storage: At least 2.5 GB to 3.5 GB of free internal flash storage for model weights and tokenizer files.

Developer Options & AICore Persistent Mode

On Pixel 8 / 8a and certain development builds, Gemini Nano must be enabled manually:

  1. Open Android Settings -> About phone and tap Build number 7 times.
  2. Open Settings -> System -> Developer options.
  3. Scroll to AICore Settings (or AiCore Persistent Mode).
  4. Enable Enable on-device Gemini Nano.
  5. Enable Enable Aicore Persistent Mode (keeps weights resident in RAM, avoiding 500ms–2000ms cold-start initialization latency).
  6. If status stays downloadable/unavailable, connect to unmetered Wi-Fi and a charger, then tap Force Model Download.

Verified GenAiException.ErrorCode (beta5) & AICore Error Taxonomy

Error codes surfaced by com.google.mlkit.genai.common.GenAiException$ErrorCode (genai-prompt:1.0.0-beta5) and Android AICore (assets/docs/genai.md.txt & PaiosModelHelper.kt):

Error Code Constant Meaning & Root Cause Recovery / PAIOS Behavior
-101 AICORE_INCOMPATIBLE AICore APK is missing or version is too low (legacy doc alias: MODEL_BUSY; runtime busy state is ErrorCode.BUSY = 9). Install or update Android AICore from Google Play and recheck device eligibility.
9 BUSY NPU/hardware accelerator is busy executing another inference request. Classified by PaiosModelHelper.isBusyException; retry with 150ms–500ms exponential jitter.
12 REQUEST_TOO_LARGE Prompt tokens + maxOutputTokens exceed the hardware context window (4,096 on v3, up to 8,192 on v4). Pruned via token-budgeted sliding window + automatic compact-budget retry (600 history / 400 system chars).
4 / 11 REQUEST_PROCESSING_ERROR / RESPONSE_PROCESSING_ERROR Prompt or generated output triggered AICore safety/policy filters. Overlay/engine strips untrusted/sensitive context via [POLICY FALLBACK RETRY] or reports clean error state.
27 PER_APP_BATTERY_USE_QUOTA_EXCEEDED Daily AICore per-app battery inference quota exceeded. Defer non-urgent inference, plug in device, or retry later.
30 BACKGROUND_USE_BLOCKED Inference attempted from background without an active foreground window or service. Handled via foreground UI or Mode A translucent status pill in MeshOverlayActivity.
8 / 16 NOT_AVAILABLE / NOT_SUPPORTED Model weights not downloaded (8) or device lacks supported NPU hardware (16). Checked via getAvailableFeatures() / checkStatus(); prompts Wi-Fi download or surfaces unsupported state cleanly.
601 BINDING_FAILURE AICore 4-CONNECTION_ERROR: failed to bind to the AICore system service (common immediately after device setup or AICore reinstall). Update Android AICore, restart device, or reinstall PAIOS.
606 FEATURE_NOT_FOUND AICore 3-PREPARATION_ERROR: AICore system stub is installed, but Google Play / OEM firmware has not provisioned the Gemini Nano feature catalog yet (also occurs with unlocked bootloaders, and on certain Xiaomi/Poco firmwares). AIEngine.isAiCoreFeatureNotFoundError surfaces a dedicated OEM provisioning diagnostic card in Setup (IntroPage) and Model Settings; keep internet connected and reboot after AICore updates.
1-DOWNLOAD_ERROR Download / Storage Failure Network host resolution (UNAVAILABLE), metered Wi-Fi block, or insufficient internal storage (< 2.5–3.5 GB free). Ensure unmetered Wi-Fi, charger connection, and sufficient free disk space; AIEngine caps recursive download retries at maxDownloadErrorRetries = 2.

Related Pages: Architecture & Model Variants · Offline Tooling & Built-in Documentation · AI-Core

Clone this wiki locally