If you believe you've found a legitimate security vulnerability in the IRIS Neural OS Agent, please report it privately. Do not open public GitHub issues for critical zero-days, Remote Code Execution (RCE) flaws, or IPC bridge escapes.
Report vulnerabilities directly via email to the Lead Architect:
Please allow up to 48 hours for an initial response. IRIS is currently a solo-developed project, but all severe reports affecting the integrity of the host machine are triaged with the highest priority.
To ensure rapid triage, please include:
- Title & Severity Assessment (Low/Medium/High/Critical)
- Affected Component (e.g., Main Process IPC, React UI, LanceDB Oracle, Protected Core Tooling)
- Technical Reproduction (Exact steps to trigger the flaw)
- Demonstrated Impact (What does this allow an attacker to do?)
- Environment (OS Version, IRIS Version)
- Remediation Advice (Suggested fix, if applicable)
Reports without clear reproduction steps or demonstrated impact will be deprioritized.
As IRIS operates on a dual-license/sponsorship model, the React frontend is open-source, while the core Node.js backend (Voice Engine, Tool Execution, OS Automation) is closed-source and compiled into V8 Bytecode.
- Black-Box Testing: Security researchers are welcome and encouraged to perform black-box testing against the compiled binaries (
.exe,.app,.AppImage). - Source-Code Auditing: If you are an active sponsor in the Enterprise or Insider tiers with source-code access, you are bound by your respective license agreements, but responsible disclosure of vulnerabilities found during source review is highly appreciated.
IRIS is not a cloud-based web app. It is a local, kernel-level Operating System extension built on Electron. Because of this, the security model operates under the "Trusted Operator" paradigm.
IRIS assumes that anyone who has unlocked the host machine and launched the application is the Trusted Operator.
- IRIS is designed to execute commands, read files, click the screen, and modify the OS on behalf of the user.
- If a user explicitly asks IRIS to delete a file, and IRIS deletes it, that is a feature, not a vulnerability. - Vulnerabilities are strictly defined as actions taken without the user's consent, or malicious escalation bypassing the IPC bridge.
IRIS does not model one installation as a multi-tenant, adversarial boundary.
- It is designed for one user per machine/OS profile.
- If multiple mutually untrusted users share the same OS login profile, the security boundary is already broken at the OS level, not by IRIS.
Privacy is absolute. IRIS operates on a strict zero-trust architecture regarding external servers.
- Your API keys (Gemini, Groq, Tavily, Hugging Face) NEVER touch our servers.
- Credentials are encrypted locally using your Operating System's native secure keychain:
- Windows:
DPAPIvia ElectronsafeStorage - macOS: Apple Keychain
- Linux: Secret Service API
- Windows:
- The keys are stored in a local, encrypted
iris_secure_vault.jsonfile. - Out of Scope: Reports demonstrating that a malicious actor who already has root access to your machine can decrypt this file are out of scope. If an attacker has root, the machine is already compromised.
The following scenarios are considered expected behavior under the IRIS threat model and will be closed as invalid or no-action:
- Prompt Injection (Without Boundary Bypass): "Tricking" the LLM via text injection is out of scope unless it results in an unauthorized bypass of the Electron IPC bridge or executes a restricted OS command without user confirmation.
- Local Physical Access: Any attack that requires the attacker to physically sit at the unlocked host machine.
- Malicious Workspace Files: "An attacker writes a malicious payload into
notes.txt, and the RAG Oracle reads it." Reading files is the Oracle's job. Unless you can prove the RAG pipeline executes the text as arbitrary code, this is out of scope. - Expected OS Execution: Reports treating explicit operator-control surfaces (like the
run_terminalorclick_on_screentools) as vulnerabilities. These are intentional, trusted-operator features. - Missing Network Headers: Missing HSTS or similar web-centric headers on local Electron
file://orlocalhostprotocols. - Bytecode Extraction: Attempting to reverse-engineer the V8
.jscfiles to extract the proprietary source code is a licensing violation, not a security vulnerability report.
We are highly interested in reports regarding:
- IPC Bridge Escapes: Any method where the untrusted React Renderer process can execute arbitrary Node.js code in the Main Process without using the predefined
ipcMain.handlechannels. - Remote Code Execution (RCE): Any method where an external, remote attacker can force the IRIS engine to execute code without the local Trusted Operator's consent.
- Vault Key Leakage: Flaws in how
safeStorageencrypts/decrypts the BYOK credentials, leading to keys being logged in plaintext, exposed to the Renderer process unnecessarily, or leaked over the network. - Path Traversal: Flaws in the file management tools that allow the AI to bypass intended directory restrictions (if configured) during autonomous operations.
Currently, IRIS does not have a funded cash bug bounty program.
However, responsible disclosure of Critical vulnerabilities (such as confirmed RCE or IPC escapes) will be rewarded with Complimentary Lifetime Enterprise/Alpha Sponsorship Access, granting you full, unrestricted access to the closed-source backend codebase and direct architectural communication lines with the developer.