🌌 WAYBIG: Cinematic Desktop AI Engine

WAYBIG is a high-performance, local desktop AI agent platform. Powered by an Electron container with a React-TypeScript-Vite frontend, WAYBIG couples raw system capabilities with a cinematic, glassmorphic interface and Gemini intelligence.

---

✨ Features

• 🧠 Desktop AI Agent: Built-in Gemini agent with safe, local shell and filesystem access.
• 🎨 Cinematic Glassmorphism: Stunning UI experience featuring floating gradient blobs, smooth animations, and a retro boot splash sequence.
• 📊 Interactive Telemetry Canvas: Built-in rendering engines for dynamic telemetry tables and custom vector load charts (triggered by /data or /chart commands).
• 📝 Rich Markdown Rendering: Native, styled output parser that formats headings, lists, inline code, and blockquotes with an instant "Copy Code" button.
• 🔒 Destructive Action Gate: Safety confirmation dialogs for file overwriting, deletion, and command execution, coupled with secure local audit logs.
• 📁 Workspace & Sessions: Full-featured chat management with sessions pinning, renaming, and persistent database storage.

---

🛠️ Technology Stack

• Frontend: React 19, TypeScript, Vite
• Shell Container: Electron 43
• Core AI Integration: @google/genai (Gemini SDK)
• Styling: Vanilla CSS with curated HSL color systems and glassy blur overlays
• Icons: Lucide React
• Storage: local JSON store via electron-store

---

📁 Project Structure

├── agent/                  # Agent-loop and tool executors
│   ├── providers/          # Gemini API streaming provider
│   └── tools/              # Filesystem, shell executors, and schemas
├── main/                   # Electron main process entry & IPC handlers
├── src/                    # React frontend application
│   ├── assets/             # Media and svg resources
│   ├── components/         # Boot splash screen, main page, and Markdown renderer
│   ├── App.tsx             # Main App layout router
│   └── index.css           # Core cinematic design token styling
├── scripts/                # Development startup script
└── package.json            # NPM dependencies & scripts

---

🚀 Getting Started

📋 Prerequisites

• Node.js: v18+ recommended
• Git: For version control
• Gemini API Key: Retrieve from Google AI Studio

🔧 Installation

1. Clone the repository:

   git clone https://github.com/Umesh-369/WAYBIG.git
   cd WAYBIG

2. Install dependencies:

   npm install

3. Set up your environment: Create a .env file in the root directory:

   VITE_GEMINI_API_KEY=your_gemini_api_key_here

🏃 Running locally

To start the Electron application in development mode with hot-reloading:

npm run dev:electron

To run only the web frontend in the browser:

npm run dev

---

📦 Building for Production

Compile TypeScript and build the production-ready package:

npm run build

---

💡 Quick UI Commands

Type these inside the WAYBIG console input to trigger mock telemetry renders:

• /data — Renders a cinematic grid showing virtual shard status and data.
• /chart — Renders an active pipeline load distribution graph.