Metadata-Version: 2.4
Name: synapse-assistant-ai
Version: 0.1.0
Summary: Free offline voice-controlled AI assistant. Install → Run → Talk.
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: vosk>=0.3.45
Requires-Dist: sounddevice>=0.4.6
Requires-Dist: pyttsx3>=2.90
Requires-Dist: ollama>=0.4.0
Requires-Dist: python-telegram-bot>=21.0
Requires-Dist: opencv-python-headless>=4.8.0
Requires-Dist: ultralytics>=8.2.0
Requires-Dist: pytesseract>=0.3.10
Requires-Dist: apscheduler>=3.10.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pywhatkit>=5.4
Requires-Dist: duckduckgo-search>=5.0
Requires-Dist: numpy

# 🤖 Super-AI — Free Offline Voice-Controlled Assistant

**Install. Run. Talk.** That's it.

## Install (one command)

```bash
cd alright
pip install .
```

## Run (one command)

```bash
superai
```

The first time you run it, an interactive setup will start right in your terminal:
- It will ask what you want to name your AI (e.g., Jarvis, Friday).
- It will ask if you want to set up Telegram notifications.
- **You simply paste your Telegram Bot Token and Chat ID directly in the terminal** when prompted.

Once setup is done, your AI will automatically message you on Telegram whenever it finishes a background task. Then it will auto-download the necessary AI files (~1.1 GB, one-time only).

After that, it starts instantly. Just talk:

> **"Jarvis, open youtube"**

## What it can do

| Say this | It does this |
|----------|-------------|
| "Jarvis, **open google**" | Opens google.com in browser |
| "Jarvis, **open youtube**" | Opens youtube.com |
| "Jarvis, **launch Safari**" | Opens Safari app |
| "Jarvis, **play** /path/to/song.mp3" | Plays media file |
| "Jarvis, **send whatsapp** to +919876543210 — hello" | Automates sending WhatsApp message |
| "Jarvis, **search web** for latest AI news" | Opens Chrome & tells you the top web result |
| "Jarvis, **send message** — meeting at 5" | Sends Telegram message |
| "Jarvis, **send voice note** — I'll be late" | Sends voice note on Telegram |
| "Jarvis, **set reminder** 5 minutes — drink water" | Reminds you in 5 min |
| "Jarvis, **what is Python?**" | Answers your question by voice |
| "Jarvis, **analyse video** /path/to/clip.mp4" | Tells what's in the video |

## Requirements

- Python 3.10+
- Microphone
- 6 GB RAM (minimum)
- ~1.5 GB disk space (for AI files)
- Internet (only for first-time download and web searches)

## How it works

```
You speak → AI Brain → Action / Answer → Speaks back
```

Everything runs locally on your machine. No cloud. No API bills. No data leaves your computer.

## License

MIT
