ZNinja
Architecture.
Executive Summary (TL;DR)
ZNinja is a native Windows AI utility that leverages low-level OS hooks and Display Affinity to provide a completely invisible, low-latency assistant experience. It uses locally encrypted API management and a dynamic failover engine to ensure privacy and session continuity.
ZNinja is built on an Electron runtime that integrates directly with Windows system layers to provide an invisible AI chatbot experience.
SafeStorage
Native Windows DPAPI integration for locally encrypted API management.
Win32 Bindings
Direct hardware-level interactions via Koffi for state and hotkey management.
AI Intelligence
Native integration with Google Generative AI (Gemini) for low-latency logic.
System Optimization.
By identifying as a System Utility, the tool maintains a professional presence in the process table while ensuring all AI operations occur in an isolated background thread.
Service Host
Runtime.
ZNinja operates as a standard system utility known as the "Service Host Runtime." Engineered as a lightweight AI chatbot, it integrates directly with the OS layer to provide assistance without appearing in screen captures or traditional application lists.
Window Display Affinity
Utilizes native Win32 SetWindowDisplayAffinity to ensure the UI is excluded from all screen capture, recording, and streaming software for total privacy.
System Utility Identification
Identifies as a background utility within the system process table, maintaining a professional and non-intrusive footprint.
Native Win32 Bindings
Leverages direct kernel and user32 bindings for hotkey intercepting and state management, bypassing high-overhead UI frameworks during operation.
"The most powerful tool is the one that disappears when its work is done."
Shadow Circuit
Communication Logic Flow & Pulse
Stealth Tech.
Isolation of concerns is handled via a three-tier sandbox environment. Explore the filesystem and live system console below.
Project Explorer
ZN-2.6.0 STABLE
Direct Console
Session: active
Security & Privacy
Technical specifications for data protection and system isolation protocols.
SafeStorage (DPAPI)
Credentials and sensitive configurations are cryptographically sealed using the native Windows Data Protection API, tied to your system user account.
Local Ecosystem
The AI chatbot operates entirely within your local machine. No logs, history, or telemetry data are ever transmitted to external servers.
Display Affinity
The UI uses OS-level window affinity settings to exclude the application interface from all screen-monitoring and capture APIs.
Isolated Execution Bridge
Communication between the user interface and system layer is handled via a secured IPC (Inter-Process Communication) bridge. This prevents arbitrary code injection and ensures that only verified logic flows can interact with Win32 system hooks.
Logic
Failover.
The multi-tier failover engine ensures uninterrupted AI availability by intercepting service degradation in real-time and rotating through a cryptographic key pool.
Real-time Interception
The engine monitors response headers for rate-limit signals (429) and instantly swaps keys before the user session is interrupted.
Graceful Fallback
In the event of a model-specific service outage (503), logic flows are automatically rerouted to a standby model variant (e.g., from Pro to Flash).
Local Routing Buffer
Requests are queued and retried automatically on background threads using the next available verified key in the rotation matrix.
Rotation Matrix
Tactical Reference
Comprehensive operational manual for system-level controls and interactive shortcuts.
Initialization
Windows Package Manager
winget install gajju44.ZNinjaClick to copynpm run devnpm run dev:devModeGlobal Intercepts
CLI Operations
zninjazninja --setupzninja --versionzninja --helpKey
Definitions.
WDA (Windows Display Affinity)
A native Windows API used to prevent specific windows from being captured by screen recording, streaming, or screenshot software.
Ghost Mode
A state where the ZNinja window is click-through and remains invisible to the operating system's focus-tracking systems, effectively bypassing tab-switch detection.
Logic Failover Engine
A proprietary ZNinja system that automatically detects API rate limits (HTTP 429) and rotates to a healthy key from a pre-configured pool without interruption.
Ninja Engine
The core rendering pipeline of ZNinja that integrates directly with Windows GDI to maintain a low-level presence that is invisible to higher-level capture hooks.
Technical
Blueprint.
"ZNinja architecture is defined by total local isolation and native performance. Every bridge is secured by the OS itself."
Common
Inquiries.
ZNinja is a desktop application that acts as a personal AI assistant. It allows you to chat with AI models without being detected with features like stealth mode & ghost mode.