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-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:

  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.1

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.1
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)

Table of built distributions (wheels) for ansh-assistant 1.0.1
File Interpreter ABI Platform Actions
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.

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