echo-ai-agent 1.0.0

package/.env.example

@@ -0,0 +1 @@
+GOOGLE_AI_API_KEY=your_gemini_api_key_here

package/CHANGELOG.md

@@ -0,0 +1,70 @@
+# Changelog
+
+All notable changes to Echo AI Agent will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-07
+
+### 🎉 Initial Release
+
+#### Added
+- ✨ Beautiful holographic UI with animated blobs and rings
+- 🧠 Google Gemini 2.0 Flash Lite integration for AI-powered commands
+- 🎤 Voice control using Web Speech API
+- 🔊 Text-to-speech responses
+- 🎨 6 stunning themes (Cyan, Purple, Green, Gold, Red, Blue)
+- 💻 Cross-platform support (Windows, macOS, Linux)
+- ⚙️ Interactive setup wizard
+- 🔧 Configuration management system
+- ⌨️ Global hotkey support (Ctrl+Shift+E)
+- 📦 npm package with CLI interface
+- 🌐 Web search functionality
+- 📁 File and folder management
+- 📸 Screenshot capability
+- 🖥️ System information queries
+- ⏰ Time and date commands
+- 📂 Directory listing
+- 🔗 URL opening in default browser
+
+#### Features
+- Transparent, always-on-top window
+- Customizable window position (5 presets)
+- Customizable window size (3 sizes)
+- Real-time audio visualization
+- Persistent configuration storage
+- Post-install welcome message
+- Comprehensive CLI commands
+
+#### Documentation
+- Professional README with badges
+- MIT License
+- Setup guide
+- Command examples
+- Configuration documentation
+
+---
+
+## [Unreleased]
+
+### Planned Features
+- [ ] Plugin system for custom commands
+- [ ] Cloud sync for settings
+- [ ] Multi-language support
+- [ ] Custom wake word detection
+- [ ] Advanced automation workflows
+- [ ] Mobile companion app
+- [ ] Integration with smart home devices
+- [ ] Voice training for better recognition
+
+---
+
+## Version History
+
+### Version 1.0.0 - Initial Release
+The first public release of Echo AI Agent, featuring a complete JARVIS-inspired desktop assistant with voice control, AI intelligence, and beautiful UI.
+
+---
+
+[1.0.0]: https://github.com/MuhammadUsmanGM/Echo/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muhammad Usman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,336 @@
+<div align="center">
+
+# 🤖 Echo AI Agent
+
+### *Your Personal JARVIS-Inspired Desktop Assistant*
+
+[![npm version](https://img.shields.io/npm/v/echo-ai-agent.svg?style=flat-square)](https://www.npmjs.com/package/echo-ai-agent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Node Version](https://img.shields.io/node/v/echo-ai-agent.svg?style=flat-square)](https://nodejs.org)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey?style=flat-square)](https://github.com/MuhammadUsmanGM/Echo)
+
+**Voice-controlled • AI-powered • Beautiful • Cross-platform**
+
+[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Themes](#-themes) • [Commands](#-commands) • [Contributing](#-contributing)
+
+</div>
+
+---
+
+## ✨ Features
+
+### 🎨 **Premium Holographic UI**
+- Stunning animated holographic core with liquid morphing effects
+- Multiple beautiful themes (Cyan, Purple, Green, Gold, Red, Blue)
+- Transparent, always-on-top window that doesn't interrupt your workflow
+- Smooth CSS3 animations for a premium feel
+
+### 🧠 **AI-Powered Intelligence**
+- Powered by **Google Gemini 2.0 Flash Lite** for advanced reasoning
+- Natural language understanding for intuitive commands
+- Context-aware responses with JARVIS-like personality
+- Function calling for seamless system integration
+
+### 🎤 **Voice & Text Control**
+- Hands-free voice commands using Web Speech API
+- Text-to-speech responses with customizable voices
+- Real-time audio visualization that reacts to your voice
+- Automatic wake-up on voice detection
+
+### 💻 **Cross-Platform System Control**
+- **Windows**, **macOS**, and **Linux** support
+- Open applications, search the web, manage files
+- Take screenshots, get system info, check time/date
+- Create folders, copy/delete files, and more
+
+### ⚙️ **Highly Customizable**
+- 6 stunning pre-built themes
+- Configurable window position and size
+- Global hotkey support (default: `Ctrl+Shift+E`)
+- Always-on-top toggle
+- Persistent configuration storage
+
+### 🔌 **Developer-Friendly**
+- Clean, modular architecture
+- Easy to extend with custom commands
+- Plugin system ready
+- Well-documented codebase
+
+---
+
+## 🚀 Installation
+
+### Quick Install (Recommended)
+
+```bash
+npm install -g echo-ai-agent
+```
+
+### From Source
+
+```bash
+git clone https://github.com/MuhammadUsmanGM/Echo.git
+cd Echo
+npm install
+```
+
+---
+
+## 📖 Usage
+
+### First Time Setup
+
+Run the interactive setup wizard:
+
+```bash
+echo setup
+```
+
+This will guide you through:
+1. Setting up your Google Gemini API key ([Get one free](https://aistudio.google.com/))
+2. Choosing your theme
+3. Configuring window position and size
+4. Setting preferences
+
+### Launch Echo
+
+```bash
+echo start
+```
+
+Or simply:
+
+```bash
+echo
+```
+
+### CLI Commands
+
+```bash
+echo start          # Launch Echo AI Agent
+echo setup          # Run setup wizard
+echo config --list  # View current configuration
+echo themes         # List available themes
+echo info           # Display system information
+echo --help         # Show all commands
+```
+
+---
+
+## 🎨 Themes
+
+Echo comes with 6 stunning themes:
+
+| Theme | Color | Description |
+|-------|-------|-------------|
+| **Cyan** | ![#00f2ff](https://via.placeholder.com/15/00f2ff/000000?text=+) `#00f2ff` | Classic JARVIS (Default) |
+| **Purple** | ![#a855f7](https://via.placeholder.com/15/a855f7/000000?text=+) `#a855f7` | Royal Purple |
+| **Green** | ![#00ff88](https://via.placeholder.com/15/00ff88/000000?text=+) `#00ff88` | Matrix Green |
+| **Gold** | ![#ffd700](https://via.placeholder.com/15/ffd700/000000?text=+) `#ffd700` | Iron Man Gold |
+| **Red** | ![#ff0055](https://via.placeholder.com/15/ff0055/000000?text=+) `#ff0055` | Cyberpunk Red |
+| **Blue** | ![#0088ff](https://via.placeholder.com/15/0088ff/000000?text=+) `#0088ff` | Ocean Blue |
+
+**Change theme:**
+```bash
+echo config --set theme purple
+```
+
+---
+
+## 🎯 Commands
+
+### Voice Command Examples
+
+- **"Open Chrome and search for the latest news"**
+- **"Create a folder named Project-Echo on my desktop"**
+- **"What's the current time?"**
+- **"Take a screenshot"**
+- **"Show me system information"**
+- **"Open Spotify"**
+- **"List files in my home directory"**
+
+### Supported Actions
+
+| Action | Example Command |
+|--------|----------------|
+| 🌐 Web Search | "Search for AI news" |
+| 📁 Create Folder | "Create a folder named MyProject" |
+| 📸 Screenshot | "Take a screenshot" |
+| 🖥️ System Info | "Show system information" |
+| ⏰ Time/Date | "What time is it?" |
+| 📂 List Files | "List files in Documents" |
+| 🚀 Open Apps | "Open VS Code" |
+| 🔗 Open URL | "Open github.com" |
+
+---
+
+## ⚙️ Configuration
+
+### Configuration File
+
+Echo stores configuration in `~/.config/echo-ai-agent/config.json`
+
+### Available Settings
+
+```javascript
+{
+  "theme": "cyan",              // cyan, purple, green, gold, red, blue
+  "position": "bottom-right",   // top-left, top-right, bottom-left, bottom-right, center
+  "size": "medium",             // small, medium, large
+  "alwaysOnTop": true,          // true, false
+  "hotkey": "CommandOrControl+Shift+E",
+  "apiKey": "your_api_key_here"
+}
+```
+
+### Manage Configuration
+
+```bash
+# View all settings
+echo config --list
+
+# Set a value
+echo config --set theme purple
+echo config --set position center
+echo config --set size large
+
+# Reset to defaults
+echo config --reset
+```
+
+---
+
+## 🔑 API Key Setup
+
+Echo uses Google's Gemini AI for intelligent command processing.
+
+1. Visit [Google AI Studio](https://aistudio.google.com/)
+2. Create a free API key
+3. Run `echo setup` and enter your key
+4. Or manually set it: `echo config --set apiKey YOUR_KEY`
+
+**Note:** The free tier includes generous limits perfect for personal use.
+
+---
+
+## 🛠️ Development
+
+### Project Structure
+
+```
+Echo/
+├── cli.js                 # CLI entry point
+├── main/
+│   ├── main.js           # Electron main process
+│   └── preload.js        # Preload script
+├── services/
+│   ├── gemini.js         # AI brain
+│   └── system.js         # System actions
+├── scripts/
+│   ├── config-manager.js # Configuration management
+│   ├── setup-wizard.js   # Interactive setup
+│   └── postinstall.js    # Post-install script
+├── ui/
+│   ├── index.html        # UI markup
+│   ├── style.css         # Styles
+│   └── renderer.js       # Renderer process
+└── package.json
+```
+
+### Run in Development Mode
+
+```bash
+npm run dev
+```
+
+### Build from Source
+
+```bash
+git clone https://github.com/MuhammadUsmanGM/Echo.git
+cd Echo
+npm install
+npm start
+```
+
+---
+
+## 🌟 Why Echo?
+
+| Feature | Echo | Other Assistants |
+|---------|------|------------------|
+| **Beautiful UI** | ✅ Holographic animations | ❌ CLI or basic UI |
+| **Privacy** | ✅ Local-first, minimal cloud | ❌ Cloud-dependent |
+| **Customizable** | ✅ Themes, positions, sizes | ❌ Fixed appearance |
+| **Cross-Platform** | ✅ Windows, macOS, Linux | ⚠️ Limited platforms |
+| **Open Source** | ✅ MIT License | ❌ Proprietary |
+| **Extensible** | ✅ Plugin-ready architecture | ❌ Closed system |
+| **Free** | ✅ Completely free | ⚠️ Paid or limited |
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Here's how you can help:
+
+1. **Fork the repository**
+2. **Create a feature branch** (`git checkout -b feature/AmazingFeature`)
+3. **Commit your changes** (`git commit -m 'Add some AmazingFeature'`)
+4. **Push to the branch** (`git push origin feature/AmazingFeature`)
+5. **Open a Pull Request**
+
+### Ideas for Contributions
+
+- 🎨 New themes
+- 🔌 Plugin system implementation
+- 🌍 Internationalization (i18n)
+- 📱 Mobile companion app
+- 🧪 Test coverage
+- 📚 Documentation improvements
+
+---
+
+## 📝 License
+
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- **Google Gemini AI** for the intelligent brain
+- **Electron** for cross-platform desktop support
+- **Web Speech API** for voice recognition
+- Inspired by **JARVIS** from Iron Man
+
+---
+
+## 📞 Support
+
+- 🐛 **Bug Reports:** [GitHub Issues](https://github.com/MuhammadUsmanGM/Echo/issues)
+- 💡 **Feature Requests:** [GitHub Discussions](https://github.com/MuhammadUsmanGM/Echo/discussions)
+- 📧 **Contact:** [Your Email]
+
+---
+
+## 🗺️ Roadmap
+
+- [ ] Plugin system for custom commands
+- [ ] Cloud sync for settings
+- [ ] Mobile companion app
+- [ ] Multi-language support
+- [ ] Custom wake word detection
+- [ ] Integration with smart home devices
+- [ ] Advanced automation workflows
+- [ ] Voice training for better recognition
+
+---
+
+<div align="center">
+
+**Made with ❤️ by Muhammad Usman**
+
+⭐ Star this repo if you find it helpful!
+
+[Report Bug](https://github.com/MuhammadUsmanGM/Echo/issues) • [Request Feature](https://github.com/MuhammadUsmanGM/Echo/issues) • [Documentation](https://github.com/MuhammadUsmanGM/Echo#readme)
+
+</div>

package/cli.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const path = require('path');
+const { spawn } = require('child_process');
+const fs = require('fs');
+
+const packageJson = require('./package.json');
+const setupWizard = require('./scripts/setup-wizard');
+const ConfigManager = require('./scripts/config-manager');
+
+const config = new ConfigManager();
+
+// ASCII Art Banner
+const banner = `
+${chalk.cyan('╔═══════════════════════════════════════╗')}
+${chalk.cyan('║')}     ${chalk.bold.white('ECHO AI AGENT')}                ${chalk.cyan('║')}
+${chalk.cyan('║')}     ${chalk.gray('Your JARVIS-like Assistant')}      ${chalk.cyan('║')}
+${chalk.cyan('╚═══════════════════════════════════════╝')}
+`;
+
+program
+  .name('echo')
+  .description('A premium JARVIS-inspired AI assistant for your desktop')
+  .version(packageJson.version);
+
+program
+  .command('start')
+  .description('Launch Echo AI Agent')
+  .option('-d, --debug', 'Run in debug mode')
+  .action((options) => {
+    console.log(banner);
+    
+    // Check if configured
+    if (!config.get('configured')) {
+      console.log(chalk.yellow('⚠️  Echo is not configured yet. Running setup wizard...\n'));
+      setupWizard.run().then(() => {
+        launchEcho(options.debug);
+      });
+    } else {
+      launchEcho(options.debug);
+    }
+  });
+
+program
+  .command('setup')
+  .description('Run the interactive setup wizard')
+  .action(async () => {
+    console.log(banner);
+    await setupWizard.run();
+  });
+
+program
+  .command('config')
+  .description('Manage Echo configuration')
+  .option('-l, --list', 'List all configuration')
+  .option('-s, --set <key> <value>', 'Set a configuration value')
+  .option('-g, --get <key>', 'Get a configuration value')
+  .option('-r, --reset', 'Reset to default configuration')
+  .action((options) => {
+    if (options.list) {
+      console.log(chalk.cyan('\n📋 Current Configuration:\n'));
+      const allConfig = config.store;
+      Object.keys(allConfig).forEach(key => {
+        console.log(`  ${chalk.bold(key)}: ${chalk.gray(JSON.stringify(allConfig[key]))}`);
+      });
+    } else if (options.set) {
+      const [key, value] = options.set;
+      config.set(key, value);
+      console.log(chalk.green(`✓ Set ${key} = ${value}`));
+    } else if (options.get) {
+      const value = config.get(options.get);
+      console.log(chalk.cyan(`${options.get}: ${value}`));
+    } else if (options.reset) {
+      config.clear();
+      console.log(chalk.green('✓ Configuration reset to defaults'));
+    } else {
+      console.log(chalk.yellow('Use --list, --set, --get, or --reset'));
+    }
+  });
+
+program
+  .command('themes')
+  .description('List available themes')
+  .action(() => {
+    console.log(chalk.cyan('\n🎨 Available Themes:\n'));
+    const themes = {
+      'cyan': { color: '#00f2ff', description: 'Classic JARVIS (Default)' },
+      'purple': { color: '#a855f7', description: 'Royal Purple' },
+      'green': { color: '#00ff88', description: 'Matrix Green' },
+      'gold': { color: '#ffd700', description: 'Iron Man Gold' },
+      'red': { color: '#ff0055', description: 'Cyberpunk Red' },
+      'blue': { color: '#0088ff', description: 'Ocean Blue' }
+    };
+    
+    Object.keys(themes).forEach(name => {
+      const theme = themes[name];
+      console.log(`  ${chalk.hex(theme.color)('●')} ${chalk.bold(name)} - ${chalk.gray(theme.description)}`);
+    });
+    
+    console.log(chalk.gray('\nUse: echo config --set theme <name>'));
+  });
+
+const { execSync } = require('child_process');
+
+program
+  .command('info')
+  .description('Display system and Echo information')
+  .action(() => {
+    console.log(banner);
+    console.log(chalk.cyan('📊 System Information:\n'));
+    console.log(`  ${chalk.bold('Version:')} ${packageJson.version}`);
+    console.log(`  ${chalk.bold('Node:')} ${process.version}`);
+    console.log(`  ${chalk.bold('Platform:')} ${process.platform}`);
+    console.log(`  ${chalk.bold('Architecture:')} ${process.arch}`);
+    console.log(`  ${chalk.bold('Configured:')} ${config.get('configured') ? chalk.green('Yes') : chalk.red('No')}`);
+    console.log(`  ${chalk.bold('Theme:')} ${config.get('theme') || 'cyan'}`);
+    console.log(`  ${chalk.bold('API Key Set:')} ${config.get('apiKey') ? chalk.green('Yes') : chalk.red('No')}`);
+
+    // Simple update check
+    try {
+        const latest = execSync(`npm view ${packageJson.name} version`, { encoding: 'utf8' }).trim();
+        if (latest && latest !== packageJson.version) {
+            console.log(chalk.yellow(`\n⚠️  Update available: ${latest} (Current: ${packageJson.version})`));
+            console.log(chalk.white(`   Run `) + chalk.cyan(`npm install -g ${packageJson.name}`) + chalk.white(` to update.`));
+        } else {
+            console.log(chalk.green('\n✓ You are using the latest version.'));
+        }
+    } catch (e) {
+        // Ignore network errors during update check
+    }
+  });
+
+// Default action (no command)
+program.action(() => {
+  console.log(banner);
+  console.log(chalk.gray('Run ') + chalk.cyan('echo start') + chalk.gray(' to launch Echo'));
+  console.log(chalk.gray('Run ') + chalk.cyan('echo --help') + chalk.gray(' for more commands\n'));
+});
+
+program.parse(process.argv);
+
+// If no arguments provided, show banner and help
+if (!process.argv.slice(2).length) {
+  console.log(banner);
+  console.log(chalk.gray('Run ') + chalk.cyan('echo start') + chalk.gray(' to launch Echo'));
+  console.log(chalk.gray('Run ') + chalk.cyan('echo --help') + chalk.gray(' for more commands\n'));
+}
+
+function launchEcho(debug = false) {
+  console.log(chalk.cyan('🚀 Launching Echo...\n'));
+  
+  const electronPath = require('electron');
+  const appPath = path.join(__dirname, 'main', 'main.js');
+  
+  const args = [appPath];
+  if (debug) args.push('--inspect');
+  
+  const child = spawn(electronPath, args, {
+    stdio: 'inherit',
+    env: { ...process.env }
+  });
+  
+  child.on('close', (code) => {
+    if (code !== 0) {
+      console.log(chalk.red(`\n❌ Echo exited with code ${code}`));
+    }
+  });
+}