Your Assistant
Your Assistant is a local-first Windows desktop automation assistant that lets you control system actions, browser tasks, and workflows using voice or text commands β without relying on cloud AI or paid APIs.
Built for speed, privacy, and offline usability.
β¨ Features
π₯οΈ System Control
- Open apps like Notepad, Calculator, File Explorer
- Open files and folders
- Tell current date and time
- Shutdown / restart system (optional toggle)
π Browser Actions
- Open Google, YouTube, and common sites
- Search Google or YouTube instantly
- Navigate browser back/forward
- Quick YouTube controls
β‘ Automation
- Type text into active window
- Scroll actions
- Media key control
- Desktop workflow shortcuts
ποΈ Voice + Text Modes
- Execute commands by typing
- Execute commands by speaking
- Wake-word support (if enabled in config)
- Talkback voice feedback
π¦ Installation
β
Install via Winget (Recommended)
winget install HVS.YourAssistant
π Upgrade
winget upgrade HVS.YourAssistant
π₯ Direct Installer
Download the latest release from GitHub:
https://github.com/Harshvs2003/Your-s_Assistant_Releases/releases
π Getting Started
- Install the application
- Launch Your Assistant
- Type a command or press the microphone button
- Speak or enter your instruction
Example commands:
open notepad
search youtube for lo-fi music
type hello world
what time is it
π Privacy Philosophy
- Core assistant logic runs locally on your device
- No cloud LLM dependency
- No background tracking or analytics
β οΈ Note:
Speech recognition using recognize_google() may require internet access for transcription.
π§ OCR Support
OCR features are available when the Tesseract runtime is bundled with the installer.
Current public build supports Windows x64 runtime.
π οΈ Tech Stack
- Python 3.11
- PySide6 (GUI framework)
- SpeechRecognition
- pyttsx3 (offline TTS)
- pyautogui
- psutil
- PyInstaller packaging
- Inno Setup installer
π§© Configuration
Some features depend on configuration flags.
You can control:
- Shutdown command availability
- Wake-word activation
- Voice talkback toggle
- Automation safety restrictions
Future versions will include an in-app settings panel.
πΊοΈ Roadmap
- Custom command editor
- Better voice detection in noisy environments
- Plugin system for automation extensions
- Auto-update support
- Improved installer metadata
- Expanded browser automation
π Troubleshooting
App installed but not visible in search
Search for:
AssistantApp
Some installer metadata versions may affect display name.
Winget uninstall not working
Run:
winget list assistant
winget uninstall --name "AssistantApp version 1.0.0" --exact
Or uninstall via Windows Installed Apps page.
SmartScreen / Defender warning
Unsigned desktop apps can trigger warnings.
Always download from official release links only.
π€ Contributing
Contributions, ideas, and bug reports are welcome.
When reporting issues, include:
- Windows version
- App version
- Exact command used
- Screenshot or log snippet
β Support Development
If this project helps you, consider supporting:
π License
This project is licensed under the MIT License.
See the LICENSE file for details.
π Links
Releases
https://github.com/Harshvs2003/Your-s_Assistant_Releases/releases
Winget Package ID
HVS.YourAssistant
β Show Your Support
If you find this project useful, consider:
- β Starring the repo
- π΄ Forking it
- π Reporting issues
- π‘ Suggesting features
Your feedback helps improve the assistant for everyone.