Repository navigation
Home
Welcome to the official PAIOS (page.puzzak.paios) Wiki, synced with v1.8.9+26112001.
PAIOS is a 100% offline-by-default, private Android interface and system digital assistant powered locally by Google's Gemini Nano via Android AICore (com.google.android.aicore) and ML Kit GenAI (com.google.mlkit:genai-prompt:1.0.0-beta5).
Note
100% Offline-by-Default Privacy Guarantee: Prompts, chats, camera captures, gallery photos, and screen inspection context stay on your device. Inference runs locally on your NPU/TPU with zero cloud LLM keys or remote model servers. Optional online extension modules (Wikipedia, DuckDuckGo Instant Answer, Open-Meteo Weather) are strictly opt-in and disabled by default.
Tip
New to PAIOS or troubleshooting AICore? Start with the FAQ for offline privacy answers, ErrorCode 601/606/-101 fixes, Nano v3 vs v4, inspect_screen, and Nightly opt-in steps.
-
ML Kit GenAI
1.0.0-beta5Integration: Nativemodel.warmup(),PromptPrefixcaching (cacheSystemInstruction = true,cacheTools = true), native multi-imageImagePartlists (replacing vertical bitmap stitching),countTokens/getTokenLimit, streamingFunctionCallcapture,topK/seedsampling, non-deprecatedgetAvailableFeatures(), and verifiedGenAiException.ErrorCodeclassification (BUSY (9)vsAICORE_INCOMPATIBLE (-101)). - Reliability & Performance Pipeline: Token-budgeted sliding window context management, unpunctuated multi-sentence cutoff trimming, earlier-sentence stutter deduplication, elimination of artificial streaming delays and per-turn background doc HTTP fetches, and Kotlin lifecycle/SAF I/O/bitmap memory hardening.
-
Slim System Prompt & On-Demand Self-Knowledge: 2-sentence
system_default.mdbaseline paired with offlinequery_aicore_documentation(about_paios,paios_info,get_paios_info) RAG retrieval. -
6-Language Localization (
zh-HansParity): Full support foren,uk,zh(Traditional Chinese),zh-Hans(Simplified Chinese),de, andtrwith script/region-aware auto-detection across both the Flutter app and native Kotlin Assistant Overlay. -
System Assistant Overlay & M3x Mesh: Instant native Kotlin Digital Assistant sheet (
PaiosVoiceInteractionService+MeshOverlayActivity) with on-demandinspect_screen(3-turn TTL),AppLifecycleState.resumedchat archiving, and cross-app*.meshIPC.
Want early access to upcoming Gemini Nano v4, M3x Mesh, and UI updates?
- Google Group Tester Opt-In (Required for Play Nightlies): Join the PAIOS Nightlies Google Group.
-
Google Play Testing Program: After joining the group, opt in via Google Play Testing (
page.puzzak.paios) or view the Google Play Store listing. - GitHub Nightly Prereleases: Download signed APKs directly from Puzzaks/PAIOS Releases.
| Guide | What You Will Find |
|---|---|
| Frequently Asked Questions (FAQ) | Offline privacy, 601/606/-101 AICore fixes, Nano v3 vs v4, inspect_screen, M3x Mesh (PTK, Speech Services), zh-Hans, .md prompts, and Nightlies |
| Architecture & Model Variants | Flutter (AIEngine) + Hive 'paios_storage' + SharedPreferences bridge vs native Kotlin Overlay, Nano v3/v4, beta5 features, and reliability pipeline |
| Supported Devices & AICore Error Taxonomy | Verified hardware matrix (Pixel 8/9/10, Galaxy S24/Z6/S25, Dimensity 9300+), Developer Options setup, and GenAiException.ErrorCode recovery guide |
| System Assistant Overlay & Screen Inspection |
PaiosVoiceInteractionService, MeshOverlayActivity Mode A & Mode B, lazy inspect_screen (3-turn TTL), camera/gallery vision, and auto-archiving |
| M3x Mesh Ecosystem & Extensions | Inter-app ContentProvider (content://page.puzzak.paios.mesh), PTK (page.puzzak.ptk), Alerts, 16s IPC timeout, and upcoming Speech Services (page.puzzak.speech) |
| Offline Tooling & Built-in Documentation | 23-page Docs Explorer, 3-tier SWR sync, query_aicore_documentation RAG, and built-in offline/online extension modules |
| Localization & Prompts | 6 bundled locales, script-aware Chinese resolution, mojibake-immune Dictionary, slim system_default.md, and SAF UTF-8 .md prompt sync |
| Building from Source | Prerequisites, flutter pub get, Dart & Kotlin unit test suites, and flutter build apk --release debug-signing fallback |
| Roadmap & Changelog | Full v1.8.0–v1.8.9 release history and Phase 1–4.7 roadmap |
PAIOS is an independent, third-party open-source client and is not officially affiliated with, endorsed by, or sponsored by Google. "Gemini" is a trademark of Google, LLC. Versions prior to 1.1.2 used a legacy package ID and are no longer supported (see the FAQ).
PAIOS (page.puzzak.paios) — Synced with v1.8.9+26112001 | GitHub Repository · Nightly Google Group · Play Testing Opt-In · Report an Issue