{"id":24557427,"url":"https://github.com/pkparthk/buddy-ai","last_synced_at":"2025-10-08T23:35:25.646Z","repository":{"id":271575528,"uuid":"913895228","full_name":"pkparthk/Buddy-AI","owner":"pkparthk","description":"Buddy AI is a full-stack, AI-powered personal assistant that combines voice recognition, natural language processing, and advanced command interpretation. Built with Python (Flask) and React (TypeScript), it features smart web navigation, real-time system monitoring, weather/news APIs, and context-aware responses.","archived":false,"fork":false,"pushed_at":"2025-08-31T16:10:07.000Z","size":286,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-08T23:35:25.319Z","etag":null,"topics":["api","artificial-intelligence","flask","gtts","machine-learning","python","react","reactjs","rest-api","speechrecognition","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://buddy-ai-puce.vercel.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pkparthk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-08T15:00:57.000Z","updated_at":"2025-08-31T16:10:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"c5603429-eaa8-4f3d-8f46-7de50c13fa4f","html_url":"https://github.com/pkparthk/Buddy-AI","commit_stats":null,"previous_names":["pkparthk/buddy-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pkparthk/Buddy-AI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pkparthk%2FBuddy-AI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pkparthk%2FBuddy-AI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pkparthk%2FBuddy-AI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pkparthk%2FBuddy-AI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pkparthk","download_url":"https://codeload.github.com/pkparthk/Buddy-AI/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pkparthk%2FBuddy-AI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000733,"owners_count":26082862,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","artificial-intelligence","flask","gtts","machine-learning","python","react","reactjs","rest-api","speechrecognition","tailwindcss","typescript"],"created_at":"2025-01-23T05:16:42.846Z","updated_at":"2025-10-08T23:35:25.642Z","avatar_url":"https://github.com/pkparthk.png","language":"Python","readme":"# 🤖 Buddy AI - Your Intelligent Personal Assistant\r\n\r\n**Buddy AI** is an advanced full-stack AI-powered personal assistant that combines natural language processing and intelligent command interpretation. Built with Flask backend and React TypeScript frontend, it offers seamless voice interactions and smart automation capabilities.\r\n\r\n## 🌟 Features\r\n\r\n### 🎯 Core Capabilities\r\n\r\n- **Voice Recognition \u0026 Speech Synthesis**: Natural voice interactions with gTTS (development mode)\r\n- **Intelligent Command Processing**: Advanced pattern matching and AI-driven command interpretation\r\n- **Dynamic Web Navigation**: Smart website opening with context-aware platform selection\r\n- **Real-time System Monitoring**: CPU, memory, battery, and disk space monitoring using Psutil\r\n- **AI-Powered Conversations**: Powered by Google Gemini AI for natural conversations\r\n- **Production-Ready API**: Flask backend with CORS support and serverless deployment\r\n\r\n### 🔧 Smart Command Categories\r\n\r\n#### 🌐 Web \u0026 Search Intelligence\r\n\r\n- **Smart Search**: Automatically chooses optimal platforms (YouTube, Google, Stack Overflow, GitHub)\r\n- **Direct Website Access**: 30+ popular websites with intelligent URL resolution\r\n- **Context-Aware Searches**: \"Python tutorials\" → YouTube, \"JavaScript error\" → Stack Overflow\r\n\r\n#### 💻 System Control \u0026 Monitoring\r\n\r\n- **Real-time System Information**: Battery, memory, CPU, and disk monitoring\r\n- **Application Management**: Launch applications with smart detection\r\n- **Cross-platform Support**: Windows, macOS, and Linux compatibility\r\n\r\n#### 📊 External API Integration\r\n\r\n- **Weather Services**: Real-time weather via OpenWeatherMap API (optional)\r\n- **News Updates**: Latest news via News API integration (optional)\r\n- **Mathematical Calculations**: Complex calculations and unit conversions\r\n\r\n## 🏗️ Technical Architecture\r\n\r\n### Backend (Flask API)\r\n\r\n- **REST API**: Flask with CORS support and health monitoring endpoints\r\n- **AI Integration**: Google Gemini AI for conversational capabilities\r\n- **External APIs**: Weather, News, and location services (optional)\r\n- **System Monitoring**: Real-time metrics using Psutil\r\n- **Audio Processing**: gTTS for development environments (disabled in production)\r\n- **Environment Management**: Production and development configurations\r\n\r\n### Frontend (React TypeScript)\r\n\r\n- **Modern UI**: React 18 with TypeScript and Tailwind CSS\r\n- **Voice Interface**: Web Speech API integration for voice commands\r\n- **Real-time Chat**: Interactive conversation interface with typing indicators\r\n- **Responsive Design**: Mobile-first design with adaptive layouts\r\n- **Quick Commands**: Pre-built shortcuts for common tasks\r\n\r\n### Deployment\r\n\r\n- **Backend**: Production-ready Flask app with serverless compatibility\r\n- **Frontend**: Static build optimized for CDN deployment\r\n- **Environment Configuration**: Separate dev/production settings\r\n\r\n## 🛠️ Technology Stack\r\n\r\n### Backend\r\n\r\n- **Python 3.11+** with Flask 3.1.0\r\n- **Google Generative AI** for Gemini integration\r\n- **gTTS** for text-to-speech (development only)\r\n- **Psutil** for system monitoring\r\n- **Requests \u0026 BeautifulSoup** for web scraping\r\n- **Flask-CORS** for cross-origin support\r\n\r\n### Frontend\r\n\r\n- **React 18** with TypeScript\r\n- **Tailwind CSS** for styling\r\n- **Vite** for build tooling and development server\r\n- **Web Speech API** for voice recognition\r\n\r\n### External Services\r\n\r\n- **Google Gemini AI** (required)\r\n- **OpenWeatherMap API** (optional)\r\n- **News API** (optional)\r\n\r\n## 🚀 Quick Start\r\n\r\n### Prerequisites\r\n\r\n- Python 3.8+\r\n- Node.js 16+\r\n- Google Gemini AI API Key\r\n\r\n### Installation\r\n\r\n1. **Clone the repository**\r\n\r\n   ```bash\r\n   git clone https://github.com/pkparthk/Buddy-AI.git\r\n   cd Buddy-AI\r\n   ```\r\n\r\n2. **Set up the backend**\r\n\r\n   ```bash\r\n   # Install Python dependencies\r\n   pip install -r requirements.txt\r\n\r\n   # Create environment file\r\n   cp .env.example .env\r\n   ```\r\n\r\n3. **Configure API Keys**\r\n   Copy the example environment file and add your API keys:\r\n\r\n   ```bash\r\n   # Copy the template\r\n   cp .env.example .env\r\n   ```\r\n\r\n   Edit `.env` file and add your API keys:\r\n\r\n   ```env\r\n   GEMINI_API_KEY=your_gemini_api_key_here\r\n   OPENWEATHER_API_KEY=your_openweather_api_key_here  # Optional\r\n   NEWS_API_KEY=your_news_api_key_here                # Optional\r\n   FLASK_ENV=development\r\n   ```\r\n\r\n4. **Set up the frontend**\r\n   ```bash\r\n   cd my-app\r\n   npm install\r\n   ```\r\n\r\n### Running the Application\r\n\r\n1. **Start the backend server**\r\n\r\n   ```bash\r\n   python api.py\r\n   ```\r\n\r\n2. **Start the frontend (in a new terminal)**\r\n\r\n   ```bash\r\n   cd my-app\r\n   npm run dev\r\n   ```\r\n\r\n3. **Access the application**\r\n   Open your browser and go to `http://localhost:5173`\r\n\r\n## 🎯 Usage Examples\r\n\r\n### Voice Commands\r\n\r\n```\r\n\"Hey Buddy, open YouTube\"\r\n\"Search for machine learning tutorials\"\r\n\"What's the weather in Mumbai?\"\r\n\"Open Visual Studio Code\"\r\n\"What's my battery level?\"\r\n\"Calculate 25 * 67\"\r\n\"Search Python error on Stack Overflow\"\r\n\"Open GitHub and search React\"\r\n```\r\n\r\n### System Monitoring\r\n\r\n```\r\n\"Check CPU usage\"\r\n\"What's my memory status?\"\r\n\"Show disk space\"\r\n\"Battery information\"\r\n```\r\n\r\n### Web Navigation\r\n\r\n```\r\n\"Open Gmail\"\r\n\"Go to Facebook\"\r\n\"Visit Instagram\"\r\n\"Launch Netflix\"\r\n\"Open Google Drive\"\r\n```\r\n\r\n## 🛠️ API Configuration\r\n\r\n### Required APIs\r\n\r\n- **Google Gemini AI**: For natural language processing\r\n  - Get your key at: https://makersuite.google.com/app/apikey\r\n\r\n### Optional APIs\r\n\r\n- **OpenWeatherMap**: For weather information\r\n  - Get your key at: https://openweathermap.org/api\r\n- **News API**: For news updates\r\n  - Get your key at: https://newsapi.org/\r\n\r\n## 📁 Project Structure\r\n\r\n```\r\nBuddy-AI/\r\n├── api.py                        # Flask REST API server with CORS\r\n├── main.py                       # Core voice processing and TTS logic\r\n├── model.py                      # Enhanced Gemini AI integration\r\n├── enhanced_commands.py          # Advanced command processing engine\r\n├── external_apis.py              # Weather, news, and location APIs\r\n├── requirements.txt              # Python dependencies\r\n├── .env.example                  # Environment variables template\r\n├── render.yaml                   # Render deployment configuration\r\n├── COMPLETE_DEPLOYMENT_GUIDE.md  # Comprehensive deployment guide\r\n├── DEPLOYMENT_CHECKLIST.md       # Deployment checklist\r\n└── my-app/                       # React TypeScript frontend\r\n    ├── src/\r\n    │   ├── components/\r\n    │   │   ├── BuddyAI.tsx       # Main AI interface component\r\n    │   │   └── ui/               # Reusable UI components\r\n    │   └── App.tsx               # Root React component\r\n    ├── package.json              # Frontend dependencies\r\n    ├── tailwind.config.js        # Tailwind CSS configuration\r\n    ├── vite.config.ts            # Vite build configuration\r\n    └── vercel.json               # Vercel deployment settings\r\n```\r\n\r\n## 🚀 Deployment\r\n\r\n### Local Development\r\n\r\n1. **Backend**: `python api.py` (runs on http://localhost:5000)\r\n2. **Frontend**: `npm run dev` (runs on http://localhost:5173)\r\n\r\n### Production Deployment\r\n\r\n- **Backend**: Deploy to serverless platforms (Render, Railway, etc.)\r\n- **Frontend**: Deploy to CDN platforms (Vercel, Netlify, etc.)\r\n\r\n## 🤝 Contributing\r\n\r\nWe welcome contributions! Please:\r\n\r\n1. Fork the repository\r\n2. Create a feature branch (`git checkout -b feature/AmazingFeature`)\r\n3. Commit your changes (`git commit -m 'Add AmazingFeature'`)\r\n4. Push to the branch (`git push origin feature/AmazingFeature`)\r\n5. Open a Pull Request\r\n\r\n## 🎥 Demo\r\n\r\n🎥 [Demo Video](https://vimeo.com/1078472414?share=copy) - See the complete voice interaction experience!\r\n\r\n## 📝 License \u0026 Usage\r\n\r\nThis project is open source and available under the [MIT License](LICENSE). As a student project, feel free to use, modify, and learn from this code. If you use this project or parts of it, please provide attribution by linking back to this repository.\r\n\r\n**Note**: This project uses external APIs (Google Gemini AI, OpenWeatherMap, News API) that may have their own terms of service and usage limits.\r\n\r\n## 📞 Contact\r\n\r\n- **Email**: [0xparthk@gmail.com](mailto:0xparthk@gmail.com)\r\n- **GitHub**: [pkparthk](https://github.com/pkparthk)\r\n\r\n---\r\n\r\n**🚀 Transform your computer interaction with Buddy AI - Your intelligent personal assistant powered by cutting-edge AI technology!**\r\n\r\n_Built with ❤️ by [Parth Kothari](https://github.com/pkparthk)_\r\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpkparthk%2Fbuddy-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpkparthk%2Fbuddy-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpkparthk%2Fbuddy-ai/lists"}