Skip to content
Puzzak edited this page Nov 20, 2026 · 4 revisions

PAIOS — Personal AI Operating System

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.


v1.8.9 Highlights

  • ML Kit GenAI 1.0.0-beta5 Integration: Native model.warmup(), PromptPrefix caching (cacheSystemInstruction = true, cacheTools = true), native multi-image ImagePart lists (replacing vertical bitmap stitching), countTokens / getTokenLimit, streaming FunctionCall capture, topK / seed sampling, non-deprecated getAvailableFeatures(), and verified GenAiException.ErrorCode classification (BUSY (9) vs AICORE_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.md baseline paired with offline query_aicore_documentation (about_paios, paios_info, get_paios_info) RAG retrieval.
  • 6-Language Localization (zh-Hans Parity): Full support for en, uk, zh (Traditional Chinese), zh-Hans (Simplified Chinese), de, and tr with 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-demand inspect_screen (3-turn TTL), AppLifecycleState.resumed chat archiving, and cross-app *.mesh IPC.

Join Beta & Nightly Releases

Want early access to upcoming Gemini Nano v4, M3x Mesh, and UI updates?

  1. Google Group Tester Opt-In (Required for Play Nightlies): Join the PAIOS Nightlies Google Group.
  2. Google Play Testing Program: After joining the group, opt in via Google Play Testing (page.puzzak.paios) or view the Google Play Store listing.
  3. GitHub Nightly Prereleases: Download signed APKs directly from Puzzaks/PAIOS Releases.

Wiki Guides

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

Disclaimer

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).

Clone this wiki locally