Repository navigation
Supported Devices and AICore Errors
Puzzak edited this page Nov 20, 2026
·
1 revision
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).
| 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 |
-
Android 14+ (
minSdk = 34): With Google Play System Update (Project Mainline) dated December 2023 or newer (Android 15+ recommended). - 8 GB+ RAM: Minimum 8 GB physical RAM (12 GB+ recommended for multimodal inference without background eviction).
-
Locked Bootloader: Google AICore disables on-device Gemini Nano on devices with an unlocked bootloader (typically surfacing
606 - FEATURE_NOT_FOUND). -
Android AICore Installed & Updated:
com.google.android.aicoreactive from Google Play Store (AICore listing). - Free Storage: At least 2.5 GB to 3.5 GB of free internal flash storage for model weights and tokenizer files.
On Pixel 8 / 8a and certain development builds, Gemini Nano must be enabled manually:
- Open Android Settings -> About phone and tap Build number 7 times.
- Open Settings -> System -> Developer options.
- Scroll to AICore Settings (or AiCore Persistent Mode).
- Enable Enable on-device Gemini Nano.
- Enable Enable Aicore Persistent Mode (keeps weights resident in RAM, avoiding
500ms–2000mscold-start initialization latency). - If status stays downloadable/unavailable, connect to unmetered Wi-Fi and a charger, then tap Force Model Download.
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
PAIOS (page.puzzak.paios) — Synced with v1.8.9+26112001 | GitHub Repository · Nightly Google Group · Play Testing Opt-In · Report an Issue