IntentOS

IntentOS is an AI-powered desktop automation platform. It allows users to type natural language goals (e.g., "Take a screenshot and save it to the Desktop", "Open Notepad and type hello") and translates them into actionable Windows system commands using the Groq LLM API.

Features

• Natural Language Execution: Control your Windows PC using plain English.
• Groq LLM Engine: Fast parsing of intents into tool execution plans.
• Real-time Streaming: Watch actions execute step-by-step with live Server-Sent Events (SSE).
• System Telemetry: Monitor CPU, RAM, and top processes directly from the app.
• Sleek UI: Premium React + Electron interface with dark mode, glassmorphism, and animations.

Architecture

1. Frontend (Electron + React): The user interface where goals are entered and telemetry is displayed. Uses Zustand for state management and Framer Motion for animations.
2. Backend (Python + Flask): A local backend that serves the API and controls the desktop via libraries like pyautogui, psutil, and plyer.
3. AI Engine (Groq): The llama3-groq-70b-8192-tool-use-preview model interprets user input and outputs an array of tool calls.

Prerequisites

• Node.js (v18+)
• Python 3.10+
• Windows OS (Required for desktop automation features)
• Groq API Key

Setup & Installation

1. Python Backend

# Navigate to the backend directory
cd backend

# Create a virtual environment
python -m venv venv
venv\Scripts\activate

# Install dependencies
pip install -r ../requirements.txt

# Create .env file from the example
copy ..\.env.example ..\.env
# Note: Edit the .env file and add your real GROQ_API_KEY

2. Electron Frontend

# Install Node dependencies from the project root
npm install

Running the Application

You can run the app in development mode, which will start the React server and spawn the Electron window (and automatically start the Flask backend).

npm run electron:dev

Alternatively, to run the backend and frontend separately for easier debugging:

Terminal 1 (Backend):

cd backend
venv\Scripts\activate
python app.py

Terminal 2 (Frontend):

npm start
# Then open a 3rd terminal to launch Electron: npm run electron

Building for Production

npm run electron:build:win

This will compile the React app, bundle the Python backend (if configured to package it), and generate a .exe installer in the dist/ directory.

Safety & Permissions

IntentOS simulates keyboard strokes, opens applications, and manages files. Use with caution.

• PyAutoGUI failsafe is enabled (move your mouse to any corner of the screen to abort).
• Do not grant it admin privileges unless absolutely necessary.
• Review the backend/actions/executor.py file to see exactly what actions the system is allowed to take.

License

MIT License