Metadata-Version: 2.4
Name: ansh-assistant
Version: 1.0.2
Summary: ANSH - Your Own AI Friend: Real-time Multimodal Voice Assistant, Smart Island HUD & Autonomous AI System
Author-email: Anshu Dubey <mastgamerz37@gmail.com>
License: MIT
Project-URL: Homepage, https://getyoursoft.page.gd
Project-URL: Repository, https://github.com/mastgamerz37-ux/ansh-ai
Keywords: ai,assistant,voice,gemini,groq,hud,desktop-automation
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: PyQt6
Requires-Dist: sounddevice
Requires-Dist: keyboard
Requires-Dist: SpeechRecognition
Requires-Dist: google-genai
Requires-Dist: google-generativeai
Requires-Dist: groq
Requires-Dist: pillow
Requires-Dist: numpy
Requires-Dist: mss
Requires-Dist: pyautogui
Requires-Dist: pyperclip
Requires-Dist: pygetwindow
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Requires-Dist: ddgs
Requires-Dist: playwright
Requires-Dist: fastapi
Requires-Dist: uvicorn[standard]
Requires-Dist: cryptography
Requires-Dist: python-multipart
Requires-Dist: qrcode[pil]
Requires-Dist: psutil
Requires-Dist: pynvml
Requires-Dist: send2trash
Requires-Dist: youtube-transcript-api
Requires-Dist: python-pptx
Requires-Dist: python-docx
Requires-Dist: pypdf
Requires-Dist: openpyxl
Requires-Dist: comtypes; sys_platform == "win32"
Requires-Dist: pycaw; sys_platform == "win32"
Requires-Dist: win10toast; sys_platform == "win32"
Requires-Dist: pywinauto; sys_platform == "win32"
Requires-Dist: pywin32; sys_platform == "win32"
Requires-Dist: wmi; sys_platform == "win32"

<div align="center">

# ⚡ ANSH — Your Own AI Friend
### Autonomous Multimodal Voice Assistant • Smart Island HUD • Real-Time AI Engine
**Created & Developed by [Anshu Dubey](https://getyoursoft.page.gd)**

[![Python Version](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/mastgamerz37-ux/ansh-ai)
[![PyPI version](https://img.shields.io/badge/PyPI-ansh--ai-orange.svg)](https://pypi.org/project/ansh-ai/)
[![Auto-Updater](https://img.shields.io/badge/Auto--Updater-Enabled-brightgreen.svg)](https://github.com/mastgamerz37-ux/ansh-ai)

> 🌐 **Website & Product Key Activation:** [https://getyoursoft.page.gd](https://getyoursoft.page.gd)

</div>

---

## 🌟 What is ANSH?

**ANSH** is a production-grade personal AI assistant that can **hear, see, speak, remember, and control your computer** in real time. 

Powered by the **Gemini Live API** for ultra-low latency bidirectional audio streaming and **Groq** for high-speed sub-agent reasoning, ANSH lives seamlessly on your screen as a sleek **Smart Island HUD**, providing proactive assistance, desktop automation, and multi-step problem solving.

---

## 🚀 Key Features

| Feature | Description |
|---|---|
| 🎙️ **Real-Time Live Voice** | Full duplex bidirectional voice conversation with zero perceptible latency via Gemini Live API. |
| 🏝️ **Smart Island HUD** | Modern floating desktop widget with audio visualizer, quick actions, status pills, and context menu. |
| 🧩 **System 2 Dual AI Planner** | Autonomous multi-step goal planning, web browsing, code execution, and self-healing error recovery. |
| 👁️ **Visual Intelligence** | Real-time continuous screen inspection and webcam vision piped directly into the live session. |
| 🧠 **Long-Term Memory** | Semantic facts and preferences store that remembers user details across sessions. |
| 🖥️ **Full Desktop Control** | Launch apps, control media, adjust brightness & volume, type text, manage windows, and execute commands. |
| 🔄 **Automated GitHub Updates** | Background auto-updater that syncs latest updates from GitHub without requiring Git CLI. |
| 🔐 **3-Day Free Trial & Licensing** | Built-in 72-hour trial with cryptographic product key activation (`ANSH-XXXX-XXXX-XXXX`). |

---

## 📦 Installation & Setup

### Option 1: Install via `pip` (Recommended)

```bash
pip install ansh-ai
```

Run ANSH from any terminal:
```bash
ansh
```

---

### Option 2: Standalone Windows Installer

Download the official standalone installer:
👉 **[Download ANSH_Setup_v1.0.exe](https://getyoursoft.page.gd)**

---

### Option 3: From Source Code

```bash
# 1. Clone repository
git clone https://github.com/mastgamerz37-ux/ansh-ai.git
cd ansh-ai

# 2. Install dependencies
pip install -e .

# 3. Launch ANSH
ansh
# or
python main.py
```

---

## 🔑 Initial Configuration

On first launch, ANSH will interactively ask for your configuration in the terminal:

1. **Gemini API Key** (Free from [Google AI Studio](https://aistudio.google.com/app/apikey))
2. **Groq API Key** (Free from [Groq Console](https://console.groq.com/keys))
3. **Your Nickname** (How ANSH should address you)

> 💡 **Tip:** You can change your API keys or nickname anytime by right-clicking the **Smart Island HUD** and selecting **🔑 Change API Keys & Nickname**.

---

## 🎟️ 3-Day Free Trial & Product Keys

ANSH comes with a **3-Day Free Trial (72 Hours)** upon first launch.

- **Trial Period:** Full access to all capabilities with real-time trial countdown.
- **Product Activation:** Once trial concludes, enter your product key (`ANSH-XXXX-XXXX-XXXX`) to unlock lifetime access.
- **Get Keys:** Visit [https://getyoursoft.page.gd](https://getyoursoft.page.gd)

---

## ⌨️ Desktop Shortcuts & Voice Commands

- **Toggle Mic / Listen:** `Ctrl + Space`
- **Wake Word:** Say *"Hey Ansh"* or *"Ansh"*
- **Sample Commands:**
  - *"Search latest news on space exploration and save notes to desktop"*
  - *"Open Spotify and turn the volume up"*
  - *"Check the weather forecast for tomorrow"*
  - *"Analyze what's on my screen right now"*

---

## 🛠️ Project Structure

```text
ansh-ai/
├── actions/            # Desktop automation, tools, web search, computer settings
├── core/               # Voice engine, AGI planner, Task LLM, Auto-updater, Licensing
├── dashboard/          # Localhost command center (FastAPI + WebSocket)
├── memory/             # Semantic markdown memory store & config management
├── skills/             # Modular skill manifests & tool definitions
├── smart_island.py     # PyQt6 floating Dynamic Island HUD interface
├── ui.py               # Main UI & audio visualization window
├── main.py             # Application entrypoint and orchestration loop
└── pyproject.toml      # PEP 517 build configuration
```

---

## 👤 Author & Support

- **Lead Developer:** **Anshu Dubey**
- **Website:** [https://getyoursoft.page.gd](https://getyoursoft.page.gd)
- **GitHub:** [@mastgamerz37-ux](https://github.com/mastgamerz37-ux)
- **Repository:** [mastgamerz37-ux/ansh-ai](https://github.com/mastgamerz37-ux/ansh-ai)

---

## 📄 License

This project is licensed under the **MIT License**.
