⚡ ANSH — Your Own AI Friend
Autonomous Multimodal Voice Assistant • Smart Island HUD • Real-Time AI Engine
Created & Developed by Anshu Dubey
🌐 Website & Product Key Activation: https://getyoursoft.page.gd
🌟 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)
pip install ansh-assistant
Run ANSH from any terminal:
ansh
Option 2: Standalone Windows Installer
Download the official standalone installer: 👉 Download ANSH_Setup_v1.0.exe
Option 3: From Source Code
# 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:
- Gemini API Key (Free from Google AI Studio)
- Groq API Key (Free from Groq Console)
- 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
⌨️ 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
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
- GitHub: @mastgamerz37-ux
- Repository: mastgamerz37-ux/ansh-ai
📄 License
This project is licensed under the MIT License.
Metadata
Release files for ansh-assistant 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ansh_assistant-1.0.1.tar.gz | 325.6 kB | Without provenance | Details for ansh_assistant-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ansh_assistant-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for ansh_assistant-1.0.1-py3-none-any.whl |
Total release size: 671.9 kB
Release files / ansh_assistant-1.0.1.tar.gz
| Download URL | ansh_assistant-1.0.1.tar.gz |
|---|---|
| Size | 325.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2b636db52495bac774576c4e4038fda1099a3612568a328cd5be3bbde12fb4c7
|
|
BLAKE2b-256 checksum How to use checksums |
b76ee823f2f7b1813aab3418f1e605adf5a5c30008058162a9a3605ecccc84f5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / ansh_assistant-1.0.1-py3-none-any.whl
| Download URL | ansh_assistant-1.0.1-py3-none-any.whl |
|---|---|
| Size | 346.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f7379439c8d57e6d884ef5bf45ac0f079f01dbbc93ce427a9dfc303a351ba749
|
|
BLAKE2b-256 checksum How to use checksums |
428632226c488698a4ba8d4ca88c4bf9c22947abc21af1acc516323bd284b942
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Security for ansh-assistant 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.