Support Center

HOW CAN WE HELP?

Most issues are resolved by reading the right doc. Use the routing cards below before opening a ticket — your answer is probably already there.

Self-Service First

START HERE

90% of issues are already documented.

API Configuration Guide

Set up your BYOK (Bring Your Own Key) in under 5 minutes.

Installation Manual

Defender bypass, CLI setup, and first-launch configuration guide.

Operational

System Status

Engine heartbeat and Gemini API connection — all systems go.

Live System Status

Auto-refreshes on load

Core Engine

Operational

Gemini Live API

Operational

CLI Gateway

Operational

License Server

Operational

Frequently Asked

COMMON ISSUES

Answers to the questions that cause the most friction. Read before opening a GitHub issue.

IRIS does not carry a commercial EV code-signing certificate (those cost $300–$700/yr and are reserved for a future update). Windows SmartScreen flags any unsigned binary from an unrecognised publisher.

Fix: Click "More info" → "Run anyway" on the SmartScreen popup. Alternatively, open Windows Security → Virus & Threat Protection → scroll to "Current threats" → Allow. If Windows Defender permanently blocked the file, whitelist the IRIS install directory: `%LOCALAPPDATA%\IRIS AI`.

The complete bypass walkthrough with screenshots is in the Installation Manual above.

Issue Tracking

REPORT A BUG

All bugs are tracked on GitHub where they can be reproduced, prioritized, and fixed in the right release cycle. Please do not email bug reports.

Open a GitHub Issue

github.com/IRISX-AI

Click to open a pre-formatted bug report template on our GitHub repository. Issues are triaged within 48 hours and tagged by severity.

Report Bug on GitHub

Required Info

Reports missing this info will be closed without action. All three are mandatory.

OS Version

e.g. Windows 11 22H2 (Build 22621)

IRIS Version

e.g. IRIS Desktop v1.6.0

Terminal Error Logs

Full output — not a screenshot

Community

JOIN THE HUB

Get help from real users, share custom macros, and stay ahead of upcoming releases.

WhatsApp Community

Unofficial peer support & discussions

Connect with other IRIS developers. Share automation macros, get unofficial help from power users, discuss upcoming features, and stay plugged into the community.

Active developers inside

GitHub Discussions

Persistent threads, indexed & searchable

For technical questions that need a permanent answer. Search existing threads first — your question may already have a verified answer from the IRIS team.

github.com/IRISX-AI

Still stuck?

Contact the team directly

For billing disputes, license questions, or partnership enquiries.

irisaidevop@gmail.com

Response within 24–48 business hours. Bug reports sent to this address will not be actioned — use GitHub Issues.