Build Faster. Automate Workflows. Control your Desktop with Voice Commands.
Speak your command. IRIS executes it.
A voice-first neural execution system powered by Gemini 3.1 Live API with real-time WebRTC audio, biometric security, and autonomous system control.
- ⚡ Overview
- 🎯 What is Voice-First?
- ✨ Core Features
- 🔐 Code Protection & Security
- 💰 Sponsorship Tiers
- 🏗️ Architecture
- 💻 Tech Stack
- 🚀 Installation & Setup
- 📁 Project Structure
- 🧠 Development Philosophy
- 🤝 Contributing
- 🧩 Extending IRIS
- 🧠 Roadmap
⚠️ Disclaimer- 👨💻 Architect
- 📜 License
IRIS is not a chatbot.
It is a Voice-First Desktop AI Assistant that executes real-world actions across your system, applications, and devices—powered by Gemini 3.1 Live API with real-time bidirectional audio processing.
Speak naturally. IRIS understands intent. Real actions execute instantly.
✅ Voice-First Design – Optimized for natural speech input with real-time WebRTC audio streaming
✅ Proprietary Agent Logic – Heavily protected, production-grade agentic orchestration
✅ Production-Ready Security – V8 bytecode + ASAR integrity validation + window isolation
✅ No Code Exposure – Core agent and tools are completely hidden from public source
✅ Autonomous Execution – LangGraph-powered state machine with dynamic tool orchestration
- Rebuilt voice architecture using Gemini Live SDK
- Removed legacy WebSocket-heavy communication layer
- Improved voice responsiveness and stability
- Refactored tool execution pipeline
- Improved memory handling
- Improved vision support
- Cleaner Electron-native architecture
- Foundation for future premium modules
- Updated branding and documentation
The public repository includes:
- Desktop application framework
- User interface
- Core infrastructure
- Selected integrations
- Community-facing examples
The following production components are private:
- Core voice orchestration engine
- Advanced tool execution logic
- Internal automation systems
- Production-grade implementations
- Certain premium modules
GitHub Sponsors receive access to additional documentation, implementation examples, architecture breakdowns, and development resources depending on tier.
Sponsorship does not include access to the complete private source code.
Traditional AI assistants are text-first: you type → they respond → you read.
IRIS is voice-first: you speak → they listen & execute → actions happen in real-time.
Your Voice
↓ (WebRTC Stream)
Gemini 3.1 Live API (Real-time)
↓ (Intent Recognition)
LangGraph Agent Orchestration
↓ (Tool Selection)
Protected Tool Execution
↓ (System Actions)
Results Streamed Back to You
- Latency: < 500ms end-to-end (including network)
- Quality: Full duplex (talk while agent responds)
- Models: Gemini 3.1 Live API (primary) + Groq (Fast Responses) + Hugging Face (Open-Sourced + Local Models)
- Search: Tavily for real-time web data
No local-only limitations. IRIS connects to cloud AI, search engines, and APIs for maximum intelligence.
- 🖥️ Open App: Native application lifecycle control
- 🛑 Close App: Instant process termination
- 🗂️ Read Directory: Local folder scanning & indexing
- 📁 Create Folder: Instant directory structure generation
- 📄 Read File: Deep text & code extraction
- 📝 Write File: Autonomous disk write access
- 🔄 Manage File: Copy, move, and delete control
- 🚀 Open File: Native OS application launcher
- 🗃️ Smart Drop Zones: Viral, autonomous folder sorting
- 🔍 Index Folder: Semantic LanceDB directory ingestion
- 🔎 Smart File Search: Vector-based local file retrieval
- 🖼️ Read Gallery: Local image cache scanning
- 👁️ Analyze Photo: Direct multimodal vision processing
- ⌨️ Run Terminal: Native shell & CLI execution
- 🛠️ Open Project: Instant IDE workspace loading
- ⚙️ Activate Protocol: Context-aware coding mode switch
- 🏗️ Build File: Writing code directly to disk
- 🤖 Execute Sequence: JSON-based macro automation runs
▶️ Execute Macro: Named workflow sequence triggering- 🕳️ Deploy Wormhole: Expose localhost to public internet
- 🛑 Close Wormhole: Terminate public localhost tunnels
- 🪟 Teleport Windows: Dynamic desktop window management
- 🧩 Create Widget: Spawn live floating desktop components
- ❌ Close Widgets: Clear active floating overlays
- 🖱️ Click on Screen: AI-driven exact coordinate targeting
- 📜 Scroll Screen: Autonomous up/down page navigation
- ⚡ Press Shortcut: Global keyboard hotkey injection
- 👻 Phantom Typer: Global inline clipboard injection
- ✂️ Screen Peeler (OCR): Instant UI-to-code visual extraction
- ⌨️ Ghost Coder: Inline IDE generation (
Ctrl+Alt+Space) - 🔊 Set Volume: Master audio level control
- 📸 Take Screenshot: Instant visual context capture
- 🧠 Save Core Memory: Deep persistent identity tracking
- 📥 Retrieve Memory: Instant past context recall
- 📝 Save Note: Local markdown note generation
- 📖 Read Notes: Instant saved plan retrieval
- 📧 Read Emails: Gmail inbox scraping & summarization
- 🔍 Google Search: Live internet data retrieval (via Tavily)
- 🌤️ Get Weather: Real-time atmospheric condition checks
- 🗺️ Open Map: Interactive dark-mode map loading
- 🚗 Get Navigation: Real-time routing and directions
- 🎵 Play Spotify: Instant music & playlist execution
- 📈 Stock Price: Real-time financial ticker tracking
- 📊 Compare Stocks: Dual-ticker fundamental market analysis
- 🕷️ Hack Live Website: Viral visual DOM manipulation
- 🎨 Build Animated Web: Agentic Tailwind & GSAP generation
- 🖼️ Generate Image: High-fidelity multimodal media generation
- 📲 Send WhatsApp: Instant automated message dispatch
- 🕒 Schedule WhatsApp: Cron-based delayed message automation
- 📧 Draft Email: Autonomous message composition
- 🚀 Send Email: Action-oriented direct dispatch
- 🔔 Mobile Notifications: Read texts from connected phone
- 🔋 Mobile Info: Battery & hardware telemetry tracking
- 📤 Push File to Mobile: Seamless PC-to-phone transfers
- 📥 Pull File from Mobile: Instant phone-to-PC fetching
- 📱 Open Mobile App: Remote Android application launching
- 🛑 Close Mobile App: Remote Android process killing
- 👆 Tap Mobile Screen: Remote coordinate touch execution
- 📜 Swipe Mobile Screen: Remote directional scrolling control
- ⚙️ Toggle Hardware: Remote Wi-Fi/Bluetooth/Flashlight switching
- 🕸️ Deep Research: Autonomous Llama 3 web crawling
- 📓 Read Notion Reports: Deep sync with Notion databases
- 📚 Ingest Codebase: Deep local project Vector embedding
- 🔮 Consult Oracle: Deep local codebase RAG queries
- 🔒 Lock System Vault: Standard PIN OS lockdown protocol
- 🛡️ Biometric Encryption: Multi-face recognition OS lockdown
IRIS uses enterprise-grade code protection to secure proprietary agent logic and tool implementations:
✅ Agent Core (iris-ai.ts)
✅ Tool Implementations (tools.ts)
✅ IPC Handlers (handlers.ts)
✅ System Utilities (All Main Process code)
-
V8 Bytecode Compilation
- TypeScript → JavaScript → Binary V8 bytecode
- Result:
.jscfiles (unreadable, machine-specific) - Reverse engineering: 100+ hours of effort
-
Protected Strings Obfuscation
- Sensitive strings transformed to obfuscated functions
- Example: System prompts, tool definitions, API patterns
- Grep/string search returns nothing useful
-
ASAR Integrity Validation
- SHA256 hashing at build time
- Runtime validation at app startup
- Tampering detection: App crashes immediately
-
Window Isolation
- Renderer windows cannot directly access each other
- All inter-process communication via secure IPC bridge
- No Node.js in renderer process
- 100% BYOK (Bring Your Own Key) – Your API keys, your control
- Local Encryption – Keys stored in OS keychain, never transmitted
- Zero-Trust Architecture – All inputs validated, outputs sanitized
- No External Validation – Core logic never phones home
IRIS is built on open-source principles, but the core agent logic and proprietary tools are hidden to protect intellectual property and fund development.
What You Get:
- Public source code (UI, integrations, setup)
- Ready-to-run desktop application (
npm run dev) - Community documentation
- Public GitHub issues & discussions
- Basic example tool signatures
What You DON'T Get:
- Full agent implementation (protected)
- Complete tool source code
- Advanced configuration docs
- Priority support
Cost: FREE ✅
IRIS is built on open-source principles, but the core voice engine, agent loops, and advanced execution tools are hidden within private repositories to protect intellectual property and fund ongoing development.
Review the options below to choose your access level and support the ecosystem.
The baseline public repository contains the foundational UI layer, layout configuration, and basic ecosystem scaffolding.
- What is Included: Access to the public frontend shell (React + Tailwind + Framer Motion), community documentation, public GitHub issue tracking, and basic structural templates.
- What is Locked: Full agent execution routines, the core voice module, deep automation tool logic, and local self-hosting capability.
- Monthly Cost: Free
Directly back the future of the IRIS ecosystem and unlock standard project insight.
- GitHub Sponsor Badge: Displays a verification badge on your public GitHub profile.
- Sponsor-Only Updates: Direct access to private text updates regarding upcoming system builds.
- Development Progress Reports: Behind-the-scenes engineering logs showing what is being cooked next.
- Monthly Project Summaries: Comprehensive recaps of system changes, optimizations, and performance stats.
- Monthly Cost: $5/month (USD)
- Access Link: Sponsor @201Harsh on GitHub
Step closer to the codebase with private repository access and deep architectural insights.
- Private Repository Access: Full read access to the
iris-insidersrepository containing working functional code snippets for core agent hooks. - Early Development Previews: See upcoming UI elements and feature modules weeks before public release.
- Architecture Discussions: Participate in private development threads discussing system performance and state management.
- Behind-the-Scenes Progress: Unfiltered access to video showcases and performance benchmarks of current builds.
- Experimental Showcases: Early look at how the voice processing pipeline handles background noise filtration.
- Monthly Cost: $15/month (USD)
- Access Link: Sponsor @201Harsh on GitHub
Designed for developer-level sponsors who want to experiment with custom setups and prototype structures.
- Access to Iris-Labs: Direct membership to the
iris-labsrepository for code sharing and component testing. - Experimental AI Agents: Access to unreleased experimental agent logic scripts and prompt testbeds.
- Prototype Systems: Early-stage UI widgets, window managers, and terminal interaction mockups.
- Technical Development Logs: Deep-dive logs exploring lower-level Electron execution, IPC communication, and V8 bytecode compilation tricks.
- Alpha Feature Testing: Opportunities to run partial standalone builds of upcoming tooling systems.
- Advanced Architecture Breakdowns: Full block diagrams and technical write-ups detailing the communication between backend processes.
- Monthly Cost: $30/month (USD)
- Access Link: Sponsor @201Harsh on GitHub
The definitive sponsor tier. Get absolute proximity to the latest builds, edge implementations, and direct development feedback priority.
- Access to Iris-Alpha: Exclusive membership to the bleeding-edge
iris-alphaenvironment. - Early Alpha Builds: Downloadable compiled packages of upcoming desktop application releases for early testing.
- Upcoming Feature Previews: Full access to high-tier closed tools (including advanced automated web navigation and cross-device mobile pairing prototypes).
- Private Release Notes: Granular, code-level changelogs tracking every structural patch.
- Priority Sponsor Feedback: Direct consideration for your feature requests, tool ideas, and framework optimizations.
- Monthly Cost: $50/month (USD)
- Access Link: Sponsor @201Harsh on GitHub
Open Source + Sustainable Development
┌─────────────────────────────┐
│ Free Tier Users │
│ (Community, feedback) │
└──────────┬──────────────────┘
│
┌──────▼───────┐
│ Sponsors │
│ Fund Dev │
│ Get snippets │
└──────┬───────┘
│
┌──────▼──────────┐
│ Enterprise │
│ Full access │
│ Support + mods │
└─────────────────┘
- UI, widgets, visualizations
- Voice input/output handling
- Real-time metrics display
- LangGraph agent orchestration
- Tool execution engine
- Protected by V8 bytecode + ASAR
// Frontend
window.electron.ipcRenderer.invoke('tool-name', payload)
// Backend (Protected)
ipcMain.handle('tool-name', async (event, payload) => {
// Secure tool execution
})- Gemini 3.1 Live API – Real-time voice processing
- Groq API – Ultra-fast inference fallback
- Hugging Face – Local model support
- Tavily – Web search & research
- Electron & Vite: High-performance desktop compilation
- React 19: Component-based frontend
- Tailwind CSS v4: Utility-first styling
- Framer Motion & GSAP: Hardware-accelerated animations
- Three.js & React Three Fiber: 3D neural visualizations
- Zustand: Global state management
- Google Gemini 3.1 Live API: Primary reasoning engine + WebRTC audio
- Groq SDK: Ultra-fast inference routing
- LangGraph: Agentic state orchestration (protected)
- Hugging Face: Local model inference
- LanceDB: Vector database for RAG & memory
- V8 Bytecode: Code compilation to binary (unreadable)
- ASAR Integrity: Package validation + tampering detection
- electron-vite: Secure split-process architecture
- Context Isolation: Renderer/Main process separation
- Nut.js: Desktop automation (mouse, keyboard, coordinates)
- Puppeteer + Stealth: Headless browser & web automation
- Node Window Manager: Window lifecycle control
- Tesseract.js: OCR for visual extraction
- Native Utilities: Audio, clipboard, screenshots
- Google APIs & Auth: Gmail, Google Cloud
- Notion Client: Database sync
- Tavily Core: Web search
- Data Parsers: PDF, DOCX, HTML
git clone https://github.com/IRISX-AI/IRIS-AI
cd IRIS-AInpm installCreate .env file (copy from .env.example):
VITE_GEMINI_API_KEY=your_gemini_key
VITE_GROQ_API_KEY=your_groq_key
VITE_TAVILY_API_KEY=your_tavily_keynpm run devnpm run build:win # Windows
npm run build:mac # macOS
npm run build:linux # LinuxBenefits:
- ✅ Access to working code examples
- ✅ Advanced setup documentation
- ✅ Private support channel
How to Access:
- Become a sponsor: GitHub Sponsors
- Get private repo access via GitHub
- Clone private repository with examples
- Follow sponsor-only documentation
IRIS operates with cloud-powered AI, requiring specific API keys to function.
To ensure absolute privacy and safety, IRIS does not use local .env files to store keys. All credentials must be entered directly into the secure application interface, where they are encrypted locally on your machine via the native OS keychain.
- Open the IRIS Desktop App.
- Navigate to Settings.
- Select the API tab.
- Paste your keys and save them securely.
- Primary reasoning engine for IRIS.
- Real-time voice processing (WebRTC).
- Multimodal vision capabilities.
- Setup: Google AI Studio → Get API Key → Create.
- Ultra-fast inference fallback.
- Sub-100ms response times.
- Setup: Groq Console → API Keys → Create.
- Real-time web search & research.
- Powers Deep Research agent.
- Setup: Tavily Portal → Generate key.
- Local model inference.
- Community model access.
- Setup: Create Hugging Face account → Access Tokens.
├── assets
│ ├── banner-old.jpeg
│ └── banner.png
├── bin
│ └── iris-ai.ts
├── build
│ ├── entitlements.mac.plist
│ ├── icon.icns
│ ├── icon.ico
│ └── icon.png
├── docs
│ ├── architecture
│ │ └── system-design.md
│ ├── core-systems
│ │ ├── local-memory.md
│ │ ├── os-automation.md
│ │ └── voice-engine.md
│ ├── development
│ │ ├── setup-guide.md
│ │ └── tool-creation.md
│ ├── security
│ │ └── local-vault.md
│ ├── troubleshooting
│ │ └── common-issues.md
│ ├── AGENT_ORCHESTRATION.md
│ ├── API_INTEGRATION.md
│ ├── API_REFERENCE.md
│ ├── ARCHITECTURE.md
│ ├── AVAILABLE_TOOLS.md
│ ├── CHANGELOG.md
│ ├── CODE_PROTECTION.md
│ ├── CONTRIBUTING.md
│ ├── CUSTOMIZATION.md
│ ├── DEPLOYMENT.md
│ ├── DEVELOPMENT.md
│ ├── EXAMPLES.md
│ ├── FAQ.md
│ ├── GETTING_STARTED.md
│ ├── GLOSSARY.md
│ ├── INDEX.md
│ ├── IPC_BRIDGE.md
│ ├── PERFORMANCE.md
│ ├── ROADMAP.md
│ ├── SECURITY.md
│ ├── SPONSORSHIP_GUIDE.md
│ ├── TOOLS_SYSTEM.md
│ ├── TROUBLESHOOTING.md
│ └── VOICE_PROCESSING.md
├── resources
│ ├── logo.png
│ └── old-logo.png
├── scripts
│ ├── workflows
│ │ └── ci.yml
│ └── dependabot.yml
├── src
│ ├── main
│ │ ├── apps
│ │ │ ├── spotifyManager.ts
│ │ │ └── whatsappControl.ts
│ │ ├── auto
│ │ │ ├── website-builder.ts
│ │ │ └── widget-manager.ts
│ │ ├── config
│ │ │ └── AxiosInstance.ts
│ │ ├── constants
│ │ │ └── StreamConfig.ts
│ │ ├── gen
│ │ │ └── Image-generator.ts
│ │ ├── handler
│ │ │ └── ui-ipc-bridge.ts
│ │ ├── handlers
│ │ │ ├── PhantomControl-handler.ts
│ │ │ ├── ScreenPeeler-handler.ts
│ │ │ └── SmartDropZone-Handler.ts
│ │ ├── hooks
│ │ │ └── iris-memory.ts
│ │ ├── instructions
│ │ │ └── iris-instructions.ts
│ │ ├── lib
│ │ │ └── system.ts
│ │ ├── logic
│ │ │ ├── app-launcher.ts
│ │ │ ├── gallery-manager.ts
│ │ │ ├── ghost-control.ts
│ │ │ ├── gmail-manager.ts
│ │ │ ├── live-location.ts
│ │ │ ├── reality-hacker.ts
│ │ │ ├── telekinesis.ts
│ │ │ └── terminal-control.ts
│ │ ├── manager
│ │ │ ├── dir-load.ts
│ │ │ ├── file-launcher.ts
│ │ │ ├── file-open.ts
│ │ │ ├── file-ops.ts
│ │ │ ├── file-read.ts
│ │ │ ├── file-search.ts
│ │ │ ├── file-write.ts
│ │ │ ├── notes-manager.ts
│ │ │ └── permanent-memory.ts
│ │ ├── mobile
│ │ │ └── adb-manager.ts
│ │ ├── security
│ │ │ ├── lock-system.ts
│ │ │ └── Security.ts
│ │ ├── services
│ │ │ ├── deep-research.ts
│ │ │ ├── iris-coder.ts
│ │ │ ├── RAG-oracle.ts
│ │ │ └── wormhole.ts
│ │ ├── tools
│ │ │ └── tool.ts
│ │ ├── utils
│ │ │ ├── stocks.ts
│ │ │ └── weather.ts
│ │ ├── web
│ │ │ └── web-agent.ts
│ │ ├── workflow
│ │ │ └── workflow-manager.ts
│ │ └── index.ts
│ ├── preload
│ │ ├── index.d.ts
│ │ └── index.ts
│ └── renderer
│ ├── src
│ │ ├── assets
│ │ │ ├── gsap_logo.png
│ │ │ ├── main.css
│ │ │ └── tailwind_logo.png
│ │ ├── auth
│ │ │ ├── AuthToken.tsx
│ │ │ └── Login.tsx
│ │ ├── code
│ │ │ ├── macro-executor.ts
│ │ │ └── website-builder-api.ts
│ │ ├── components
│ │ │ ├── UI
│ │ │ │ ├── AICore.tsx
│ │ │ │ ├── LeftPanels.tsx
│ │ │ │ └── RightPanel.tsx
│ │ │ ├── MacroManagementMenu.tsx
│ │ │ ├── MiniOverlay.tsx
│ │ │ ├── ParameterEditorDrawer.tsx
│ │ │ ├── Sphere.tsx
│ │ │ ├── TerminalOverlay.tsx
│ │ │ ├── Titlebar.tsx
│ │ │ ├── ToolNode.tsx
│ │ │ └── ViewSkelrton.tsx
│ │ ├── config
│ │ │ └── AxiosInstance.ts
│ │ ├── functions
│ │ │ ├── apps-manager-api.ts
│ │ │ ├── coding-manager-api.ts
│ │ │ ├── DropZone-handler-api.ts
│ │ │ ├── file-manager-api.ts
│ │ │ ├── gallery-managet-api.ts
│ │ │ ├── gmail-manager-api.ts
│ │ │ ├── keybaord-manager.ts
│ │ │ ├── keyboard-manger-api.ts
│ │ │ ├── notes-manager-api.ts
│ │ │ ├── Sporify-manager.ts
│ │ │ └── whatsapp-manager-api.ts
│ │ ├── handlers
│ │ │ └── LockSystem-handler.ts
│ │ ├── hooks
│ │ │ └── CaptureDesktop.ts
│ │ ├── middleware
│ │ │ └── auth-middleware.tsx
│ │ ├── public
│ │ │ ├── img
│ │ │ ├── models
│ │ │ │ ├── age_gender_model-shard1
│ │ │ │ ├── age_gender_model-weights_manifest.json
│ │ │ │ ├── face_expression_model-shard1
│ │ │ │ ├── face_expression_model-weights_manifest.json
│ │ │ │ ├── face_landmark_68_model-shard1
│ │ │ │ ├── face_landmark_68_model-weights_manifest.json
│ │ │ │ ├── face_landmark_68_tiny_model-shard1
│ │ │ │ ├── face_landmark_68_tiny_model-weights_manifest.json
│ │ │ │ ├── face_recognition_model-shard1
│ │ │ │ ├── face_recognition_model-shard2
│ │ │ │ ├── face_recognition_model-weights_manifest.json
│ │ │ │ ├── mtcnn_model-shard1
│ │ │ │ ├── mtcnn_model-weights_manifest.json
│ │ │ │ ├── ssd_mobilenetv1_model-shard1
│ │ │ │ ├── ssd_mobilenetv1_model-shard2
│ │ │ │ ├── ssd_mobilenetv1_model-weights_manifest.json
│ │ │ │ ├── tiny_face_detector_model-shard1
│ │ │ │ └── tiny_face_detector_model-weights_manifest.json
│ │ │ └── Logo.png
│ │ ├── services
│ │ │ ├── get-apps.ts
│ │ │ ├── IRIS_AI.ts
│ │ │ ├── iris-ai-brain.ts
│ │ │ └── system-info.ts
│ │ ├── store
│ │ │ └── auth-store.ts
│ │ ├── tools
│ │ │ ├── deepSearch-rag.ts
│ │ │ ├── Earth-View.ts
│ │ │ ├── Hacker-api.ts
│ │ │ ├── Image-generator.ts
│ │ │ ├── live-location.ts
│ │ │ ├── Mobile-api.ts
│ │ │ ├── rag-oracle-tool.ts
│ │ │ ├── semantic-search-api.ts
│ │ │ ├── stock-api.ts
│ │ │ ├── weather-api.ts
│ │ │ ├── widget-creator.ts
│ │ │ └── wormhole-api.ts
│ │ ├── types
│ │ │ ├── form-type.ts
│ │ │ └── panel.ts
│ │ ├── UI
│ │ │ ├── IRIS.tsx
│ │ │ └── LockScreen.tsx
│ │ ├── utils
│ │ │ ├── audioUtils.ts
│ │ │ └── ErrorBox.tsx
│ │ ├── views
│ │ │ ├── APP.tsx
│ │ │ ├── Dashboard.tsx
│ │ │ ├── Gallery.tsx
│ │ │ ├── Notes.tsx
│ │ │ ├── Phone.tsx
│ │ │ ├── Settings.tsx
│ │ │ └── WorkFlowEditor.tsx
│ │ ├── Widgets
│ │ │ ├── DeepResearch.tsx
│ │ │ ├── EmailWidget.tsx
│ │ │ ├── ImageWidget.tsx
│ │ │ ├── LiveCodingWidget.tsx
│ │ │ ├── MapView.tsx
│ │ │ ├── RagOrcaleWidget.tsx
│ │ │ ├── SematicSearch.tsx
│ │ │ ├── SmartZoneWidget.tsx
│ │ │ ├── StockWidget.tsx
│ │ │ ├── WeatherWidget.tsx
│ │ │ └── WormholeWidget.tsx
│ │ ├── App.tsx
│ │ ├── env.d.ts
│ │ ├── ing.tsx
│ │ ├── IRISRoot.tsx
│ │ └── main.tsx
│ └── index.html
├── testing
│ ├── core
│ │ ├── engine
│ │ │ ├── v8
│ │ │ │ ├── context.h
│ │ │ │ └── isolate.cc
│ │ │ └── bytecode.js
│ │ ├── memory
│ │ │ └── allocator
│ │ │ └── gc.rs
│ │ └── neural
│ │ └── synapse
│ │ ├── optimizer.py
│ │ └── weights.tensor
│ ├── docs
│ │ ├── api
│ │ │ ├── test
│ │ │ │ └── test.yaml
│ │ │ └── v1
│ │ │ ├── v2
│ │ │ └── swagger.yaml
│ │ └── architecture
│ │ ├── adr
│ │ │ ├── 0001-use-rust.md
│ │ │ └── 0002-switch-to-webgpu.md
│ │ └── sdk
│ ├── plugins
│ │ ├── auth
│ │ │ └── biometrics
│ │ │ └── face_match.wasm
│ │ └── render
│ │ └── webgl
│ │ └── shaders.glsl
│ ├── scripts
│ │ └── build
│ │ └── webpack
│ │ ├── dev.config.js
│ │ └── prod.config.js
│ ├── shared
│ │ ├── types
│ │ │ └── interfaces
│ │ │ └── neural.d.ts
│ │ └── utils
│ │ └── crypto
│ │ └── aes.ts
│ ├── tests
│ │ ├── e2e
│ │ │ └── plugins
│ │ │ └── auth.spec.ts
│ │ └── unit
│ │ └── core
│ │ └── isolate.test.ts
│ ├── CONTRIBUTING.md
│ ├── docker-compose.yml
│ ├── Jenkinsfile
│ ├── LICENSE
│ └── Makefile
├── .env.example
├── Agents.md
├── banner.png
├── CHANGELOG.md
├── CLAUDE.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── DockerFile
├── electron-builder.yml
├── electron.vite.config.ts
├── eslint.config.mjs
├── LICENSE
├── package-lock.json
├── package.json
├── README.md
├── README.txt
├── SECURITY.md
├── SUPPORT.md
├── tsconfig.json
├── tsconfig.node.json
└── tsconfig.web.json
| Path | Protected? | Access |
| --------------- | ----------- | ------------- | ------ |
| iris-ai.ts | ✅ Bytecode | Sponsors only |
| tools.ts | ✅ Bytecode | Sponsors only |
| src/renderer/ | ✅ React | ✅ Open | Public |
| IPC handlers | ✅ Bytecode | Built-in only |
- Execution > Conversation – Real actions, not just chat
- Voice > Text – Natural speech input first
- Security by Default – Protection built into every build
- Modular Design – Extensible tool system
- Real-World Utility – Practical autonomous assistance
IRIS welcomes contributions! Help expand the neural forge.
- Fork the repository
- Branch off
main - Test thoroughly
- Submit PR with clear explanation
- 🐛 Bug Reports – Issues & fixes
- 📚 Documentation – Guides & examples (public)
- 🎨 UI/UX – React components (public)
- 🔗 Integrations – New API connections (public)
❌ Agent logic (protected)
❌ Tool implementations (protected)
❌ Core security code (protected)
✅ git commit -m "feat: new ui widget (#45)"
✅ git commit -m "fix: ipc memory leak (#12)"- Build custom UI widgets
- Add public integrations
- Extend renderer components
- Access example agent snippets
- Modify tool behavior (examples provided)
- Create custom workflows
- Full source code
- Custom agent implementations
- Private tool development
- Voice-first interface
- Real-time audio processing
- Production security (bytecode + ASAR)
- Plugin marketplace
- Advanced memory graph
- Multi-agent orchestration
- Desktop + Cloud hybrid
- Mobile agent integration
IRIS has deep system-level execution capabilities.
Use responsibly. The maintainers are not liable for misuse, data loss, or unintended actions.
By using IRIS, you agree:
- ✅ You understand IRIS executes real system commands
- ✅ You are responsible for API key security
- ✅ You use IRIS ethically and legally
- ✅ You do not reverse engineer protected code
Harsh Pandey
AI Systems Engineer & Creator
Connect:
- 🎬 Instagram: @201Harshs
- 💻 GitHub: @201Harsh
- 🤝 Sponsor: GitHub Sponsors
Dual License Model:
- Free Tier (Public Source): MIT License
- Sponsors & Enterprise: Custom Commercial License
See LICENSE file for details.
# You can test the frontend UI, but the core AI execution is disabled.
git clone [https://github.com/IRISX-AI/IRIS-AI](https://github.com/IRISX-AI/IRIS-AI)
cd IRIS-AI
npm install
npm run dev# 🟢 $5/mo Tier (IRIS Supporter):
# -> Gain access to basic working code snippets.
# -> (Note: This is not enough to run the full OS locally).
# ⚡ $15/mo Tier (IRIS Insider) & Above:
# -> Clone the private iris-insiders repository.
# -> Unlock local execution and full working AI agents.
# -> Join the private sponsor Discord for setup support.# 🏢 $50/mo Tier (Enterprise & Alpha):
# -> Full unprotected source code access.
# -> Commercial license + custom deployment support.
# Contact: irisaidevop@gmail.comSpeak. IRIS listens. Reality changes.
System Online. Neural OS Activated.
If you find IRIS valuable, consider:
- ⭐ Star the repository
- 💬 Share with your network
- 🤝 Sponsor development ($5/month)
- 🔗 Integrate IRIS into your workflow
- 🐛 Report bugs & suggest features
Made with ❤️ by Harsh Pandey
System Online.