Skip to main content

⚡ ANSH — Your Own AI Friend

Autonomous Multimodal Voice Assistant • Smart Island HUD • Real-Time AI Engine

Created & Developed by Anshu Dubey

Python Version License: MIT Platform PyPI version Auto-Updater

🌐 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

pip install ansh-ai

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:

  1. Gemini API Key (Free from Google AI Studio)
  2. Groq API Key (Free from Groq Console)
  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

⌨️ 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


📄 License

This project is licensed under the MIT License.

Metadata

Release files for ansh-assistant 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ansh-assistant 1.0.2
File Size Uploaded Provenance Actions
ansh_assistant-1.0.2.tar.gz 320.5 kB Without provenance Details for ansh_assistant-1.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ansh-assistant 1.0.2
File Interpreter ABI Platform Actions
ansh_assistant-1.0.2-py3-none-any.whl Python 3 none any Details for ansh_assistant-1.0.2-py3-none-any.whl

Total release size: 661.3 kB

Release files / ansh_assistant-1.0.2.tar.gz

Download URL ansh_assistant-1.0.2.tar.gz
Size 320.5 kB
Tags Source
SHA-256 checksum
How to use checksums
704b210783b0f7dd1d8ab79ff7145fc4203bd5512145a94a029b40fe8ba7d94f
BLAKE2b-256 checksum
How to use checksums
1a552092bd025dc5e691856836b2e25259b6a8cebaf673c00b36b3dfd8769a3c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / ansh_assistant-1.0.2-py3-none-any.whl

Download URL ansh_assistant-1.0.2-py3-none-any.whl
Size 340.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ad01b8a9e0f5bb2c0fa6d8a17d9f57b8c774fd5e7cef9902706f4521f2ef559f
BLAKE2b-256 checksum
How to use checksums
0b02ff69abc89af8e72b3ea360797558f0ce4b1e8074e8b1ead59f457d765d3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for ansh-assistant 1.0.2

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page