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-ai 1.0.0

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-ai 1.0.0
File Size Uploaded Provenance Actions
ansh_ai-1.0.0.tar.gz 324.9 kB Without provenance Details for ansh_ai-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ansh-ai 1.0.0
File Interpreter ABI Platform Actions
ansh_ai-1.0.0-py3-none-any.whl Python 3 none any Details for ansh_ai-1.0.0-py3-none-any.whl

Total release size: 670.4 kB

Release files / ansh_ai-1.0.0.tar.gz

Download URL ansh_ai-1.0.0.tar.gz
Size 324.9 kB
Tags Source
SHA-256 checksum
How to use checksums
7da86b797026f42d796a2101bbc8af2e27c8463a81fd9e2ebae7007c5c0f6270
BLAKE2b-256 checksum
How to use checksums
18951005f341bb15d1b2a9c2847909a0d8b157550deb902eaaa75e844fbc0157
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Release files / ansh_ai-1.0.0-py3-none-any.whl

Download URL ansh_ai-1.0.0-py3-none-any.whl
Size 345.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1f76b63d7600232ff7f63d7d251cca8c41aa3290bcddb950cdd4cae02861a338
BLAKE2b-256 checksum
How to use checksums
b774b49607bf80a494e70f6b6bd995ccce5075e2b4748c86f74fc536e67bbec5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Security for ansh-ai 1.0.0

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.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

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