synapse-assistant-ai 0.1.0__tar.gz

synapse_assistant_ai-0.1.0/PKG-INFO

@@ -0,0 +1,84 @@
+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

synapse_assistant_ai-0.1.0/README.md

@@ -0,0 +1,63 @@
+# 🤖 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

synapse_assistant_ai-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "synapse-assistant-ai"
+version = "0.1.0"
+description = "Free offline voice-controlled AI assistant. Install → Run → Talk."
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+
+dependencies = [
+    # Speech-to-Text (offline)
+    "vosk>=0.3.45",
+    "sounddevice>=0.4.6",
+
+    # Text-to-Speech (offline, system voices)
+    "pyttsx3>=2.90",
+
+    # LLM client (talks to auto-managed Ollama)
+    "ollama>=0.4.0",
+
+    # Telegram (optional at runtime, installed so it's ready)
+    "python-telegram-bot>=21.0",
+
+    # Video analysis (optional at runtime)
+    "opencv-python-headless>=4.8.0",
+    "ultralytics>=8.2.0",
+    "pytesseract>=0.3.10",
+
+    # Scheduler
+    "apscheduler>=3.10.0",
+
+    # Config
+    "python-dotenv>=1.0.0",
+
+    # WhatsApp & Web Search
+    "pywhatkit>=5.4",
+    "duckduckgo-search>=5.0",
+
+    # Utilities
+    "numpy",
+]
+
+[project.scripts]
+synapse-ai = "super_ai:start_loop"
+superai = "super_ai:start_loop"
+
+[tool.setuptools.packages.find]
+include = ["super_ai*"]

synapse_assistant_ai-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

synapse_assistant_ai-0.1.0/super_ai/__init__.py

@@ -0,0 +1,103 @@
+"""
+super_ai
+════════
+Free, offline, voice‑controlled AI assistant.
+
+Install:  pip install .
+Run:      superai
+
+That's it. Models auto‑download. Telegram notifications auto‑send.
+"""
+
+__version__ = "0.1.0"
+
+from .speech import listen, speak, check_wake_word, text_to_wav
+from .llm import ask
+from .actions import run_action
+
+
+def start_loop():
+    """
+    The WHOLE assistant. One function. Called by `superai` CLI.
+    """
+    from .config import interactive_setup, cfg
+    from .messaging import notify
+
+    # ── Interactive Setup (if first run) ──
+    interactive_setup()
+
+    # ── Banner ──
+    print()
+    print("╔══════════════════════════════════════════╗")
+    print("║     🤖  S U P E R - A I   v0.1.0        ║")
+    print("║     Free · Offline · Voice-Controlled    ║")
+    print("╚══════════════════════════════════════════╝")
+    print()
+
+    # ── Auto‑download models (first run only) ──
+    print("⏳ Checking models...")
+    from .model_manager import ensure_all_models
+    ensure_all_models()
+
+    # ── Warm up engines ──
+    print("⏳ Starting speech engine...")
+    from .speech import _ensure_vosk, _ensure_tts
+    _ensure_vosk()
+    _ensure_tts()
+
+    print("⏳ Starting AI brain...")
+    from .llm import _ensure_llm
+    _ensure_llm()
+
+    # ── Ready ──
+    print()
+    print("═" * 44)
+    print(f"  ✅ READY! Say \"{cfg.wake_word}\" + command")
+    print(f"  Example: \"{cfg.wake_word} open youtube\"")
+    print(f"  Press Ctrl+C to quit")
+    print("═" * 44)
+    print()
+
+    speak(f"Super AI is ready. Say {cfg.wake_word} followed by your command.")
+
+    # Notify on Telegram that AI is online
+    notify("🟢 Super-AI is now online and listening!")
+
+    # ── Main loop — runs forever until Ctrl+C ──
+    while True:
+        try:
+            # 1. Listen
+            text = listen(timeout=15)
+            if not text:
+                continue
+
+            # 2. Wake word?
+            command = check_wake_word(text)
+            if command is None:
+                continue  # not for us
+
+            print(f"\n🎯 Command: \"{command}\"")
+
+            # 3. Ask LLM
+            response = ask(command)
+
+            # 4. Execute or speak
+            if isinstance(response, dict):
+                # Tool‑call → run action → speak result → Telegram notify (auto)
+                result = run_action(response)
+                speak(result)
+            else:
+                # Plain answer → speak it
+                speak(response)
+
+            print()
+
+        except KeyboardInterrupt:
+            print("\n\n👋 Shutting down...")
+            speak("Goodbye!")
+            notify("🔴 Super-AI is now offline.")
+            break
+        except Exception as exc:
+            print(f"[error] {exc}")
+            speak("Sorry, something went wrong.")
+            notify(f"⚠️ Error: {exc}")

synapse_assistant_ai-0.1.0/super_ai/actions.py

@@ -0,0 +1,217 @@
+"""
+super_ai.actions
+────────────────
+OS‑level action dispatcher.
+
+LLM returns JSON → this module executes it → sends Telegram notification.
+"""
+
+import os
+import sys
+import webbrowser
+import subprocess
+import platform
+import urllib.parse
+from pathlib import Path
+from datetime import datetime, timedelta
+
+from apscheduler.schedulers.background import BackgroundScheduler
+
+from .config import cfg
+
+# ═══════════════════════════════════════════════════
+#  Scheduler (reminders)
+# ═══════════════════════════════════════════════════
+
+_scheduler = BackgroundScheduler()
+_scheduler.start()
+
+
+# ═══════════════════════════════════════════════════
+#  Action functions
+# ═══════════════════════════════════════════════════
+
+def open_url(url: str) -> str:
+    """Open a URL in the default browser."""
+    if not url.startswith(("http://", "https://")):
+        url = "https://" + url
+    webbrowser.open(url)
+    return f"Opened {url}"
+
+
+def launch_app(name: str) -> str:
+    """Launch a desktop app by name."""
+    system = platform.system()
+    try:
+        if system == "Darwin":
+            subprocess.Popen(["open", "-a", name])
+        elif system == "Linux":
+            subprocess.Popen(["xdg-open", name])
+        elif system == "Windows":
+            os.startfile(name)
+        else:
+            return f"Unsupported OS: {system}"
+        return f"Launched {name}"
+    except Exception as exc:
+        return f"Could not launch {name}: {exc}"
+
+
+def play_media(path: str) -> str:
+    """Play audio/video with default system player."""
+    filepath = Path(path).expanduser().resolve()
+    if not filepath.is_file():
+        return f"File not found: {filepath}"
+
+    system = platform.system()
+    try:
+        if system == "Darwin":
+            subprocess.Popen(["open", str(filepath)])
+        elif system == "Linux":
+            subprocess.Popen(["xdg-open", str(filepath)])
+        elif system == "Windows":
+            os.startfile(str(filepath))
+        return f"Playing {filepath.name}"
+    except Exception as exc:
+        return f"Could not play: {exc}"
+
+
+def send_message(to: str = "", body: str = "") -> str:
+    """Send Telegram text message."""
+    from .messaging import send_text
+    return send_text(to, body)
+
+
+def send_voice_note(to: str = "", text: str = "") -> str:
+    """Generate voice note from text and send via Telegram."""
+    from .speech import text_to_wav
+    from .messaging import send_voice
+
+    wav_path = text_to_wav(text)
+    return send_voice(to, wav_path)
+
+
+def analyse_video_action(path: str) -> str:
+    """Analyse a video and return summary."""
+    from .video import analyse_video
+    return analyse_video(path)
+
+
+def set_reminder(text: str, seconds: int = 60) -> str:
+    """Set a reminder — speaks + sends Telegram notification when fires."""
+    from .speech import speak
+    from .messaging import notify
+
+    def _fire():
+        msg = f"⏰ Reminder: {text}"
+        print(f"\n[reminder] {msg}")
+        speak(f"Reminder: {text}")
+        notify(msg)
+
+    run_at = datetime.now() + timedelta(seconds=int(seconds))
+    _scheduler.add_job(_fire, "date", run_date=run_at)
+    return f"Reminder set for {seconds} seconds: {text}"
+
+
+def send_whatsapp(phone: str, message: str) -> str:
+    """Send a WhatsApp message automatically using pywhatkit."""
+    try:
+        import pywhatkit
+        
+        # Resolve contact name to phone number if it exists in config
+        contact_name = phone.lower().strip()
+        if contact_name in cfg.whatsapp_contacts:
+            phone = cfg.whatsapp_contacts[contact_name]
+            
+        print(f"[action] Preparing to send WhatsApp message to {phone}...")
+        
+        # sendwhatmsg_instantly opens whatsapp web, types the message, and presses enter.
+        pywhatkit.sendwhatmsg_instantly(phone, message, wait_time=15, tab_close=True, close_time=3)
+        return f"WhatsApp message sent to {phone}"
+    except ImportError:
+        return "pywhatkit library is not installed."
+    except Exception as exc:
+        return f"Could not send WhatsApp message: {exc}"
+
+
+def search_web(query: str) -> str:
+    """Search the web using duckduckgo-search and open the browser so the user can see."""
+    try:
+        # Open browser to show the user
+        webbrowser.open(f"https://www.google.com/search?q={urllib.parse.quote(query)}")
+        
+        from duckduckgo_search import DDGS
+        with DDGS() as ddgs:
+            results = list(ddgs.text(query, max_results=2))
+            
+        if not results:
+            return f"I couldn't find any web results for {query}."
+            
+        # Get the first snippet
+        snippet = results[0]['body']
+        
+        return f"According to the web: {snippet}"
+    except ImportError:
+        return "duckduckgo-search library is not installed."
+    except Exception as exc:
+        return f"Could not search the web: {exc}"
+
+
+# ═══════════════════════════════════════════════════
+#  Dispatcher
+# ═══════════════════════════════════════════════════
+
+_ACTION_MAP = {
+    "open_url": open_url,
+    "launch_app": launch_app,
+    "play_media": play_media,
+    "send_message": send_message,
+    "send_voice_note": send_voice_note,
+    "analyse_video": analyse_video_action,
+    "set_reminder": set_reminder,
+    "send_whatsapp": send_whatsapp,
+    "search_web": search_web,
+}
+
+
+def run_action(action_data: dict) -> str:
+    """
+    Execute an action from LLM's JSON output.
+    After completion, auto-sends Telegram notification.
+
+    Parameters
+    ----------
+    action_data : dict
+        {"action": "open_url", "args": {"url": "https://google.com"}}
+
+    Returns
+    -------
+    str — result message (spoken back to user)
+    """
+    from .messaging import notify
+
+    action_name = action_data.get("action", "")
+    args = action_data.get("args", {})
+
+    func = _ACTION_MAP.get(action_name)
+    if func is None:
+        supported = ", ".join(sorted(_ACTION_MAP.keys()))
+        return f"Unknown action: {action_name}. I can do: {supported}"
+
+    try:
+        print(f"[action] ▶ {action_name}({args})")
+        result = func(**args)
+        print(f"[action] ✓ {result}")
+
+        # ── Auto‑notify on Telegram ──
+        notify(f"✅ Task done: {action_name}\n{result}")
+
+        return result
+
+    except Exception as exc:
+        err = f"Action {action_name} failed: {exc}"
+        print(f"[action] ✗ {err}")
+
+        # ── Notify failure too ──
+        notify(f"❌ Task failed: {action_name}\n{exc}")
+
+        return err

synapse_assistant_ai-0.1.0/super_ai/config.py

@@ -0,0 +1,118 @@
+"""
+super_ai.config
+───────────────
+Auto-config. User ko kuch set nahi karna.
+"""
+
+import os
+import json
+from pathlib import Path
+from dataclasses import dataclass, field
+
+# Models stored in ~/.superai/models/
+DATA_DIR = Path.home() / ".superai"
+MODELS_DIR = DATA_DIR / "models"
+CONFIG_FILE = DATA_DIR / "config.json"
+
+
+@dataclass
+class Config:
+    """All settings with defaults — works out of the box."""
+
+    # Paths
+    data_dir: Path = field(default_factory=lambda: DATA_DIR)
+    models_dir: Path = field(default_factory=lambda: MODELS_DIR)
+
+    # Speech Model
+    vosk_model_url: str = "https://alphacephei.com/vosk/models/vosk-model-small-en-in-0.4.zip"
+    vosk_model_name: str = "vosk-model-small-en-in-0.4"
+
+    # AI Brain
+    ollama_model: str = "llama3.2:1b"
+
+    # Wake word
+    wake_word: str = "hey ai"
+
+    # TTS
+    tts_rate: int = 150
+    tts_voice_index: int = 0
+
+    # Telegram (optional)
+    telegram_bot_token: str = ""
+    telegram_chat_id: str = ""
+
+    # WhatsApp Contacts (optional: {"name": "+91..."})
+    whatsapp_contacts: dict = field(default_factory=dict)
+
+    @classmethod
+    def load(cls) -> "Config":
+        DATA_DIR.mkdir(parents=True, exist_ok=True)
+        MODELS_DIR.mkdir(parents=True, exist_ok=True)
+
+        c = cls()
+        if CONFIG_FILE.exists():
+            try:
+                with open(CONFIG_FILE, "r") as f:
+                    data = json.load(f)
+                c.wake_word = data.get("wake_word", c.wake_word)
+                c.tts_rate = data.get("tts_rate", c.tts_rate)
+                c.tts_voice_index = data.get("tts_voice_index", c.tts_voice_index)
+                c.telegram_bot_token = data.get("telegram_bot_token", c.telegram_bot_token)
+                c.telegram_chat_id = data.get("telegram_chat_id", c.telegram_chat_id)
+                c.whatsapp_contacts = data.get("whatsapp_contacts", c.whatsapp_contacts)
+            except Exception:
+                pass
+        return c
+
+    def save(self):
+        data = {
+            "wake_word": self.wake_word,
+            "tts_rate": self.tts_rate,
+            "tts_voice_index": self.tts_voice_index,
+            "telegram_bot_token": self.telegram_bot_token,
+            "telegram_chat_id": self.telegram_chat_id,
+            "whatsapp_contacts": self.whatsapp_contacts,
+        }
+        with open(CONFIG_FILE, "w") as f:
+            json.dump(data, f, indent=4)
+
+    @property
+    def vosk_model_path(self) -> Path:
+        return self.models_dir / self.vosk_model_name
+
+
+cfg = Config.load()
+
+def interactive_setup():
+    """Prompt user for setup if not done yet."""
+    if CONFIG_FILE.exists():
+        return
+        
+    print("\n" + "="*50)
+    print("🚀 Welcome to Super-AI Setup!")
+    print("="*50)
+    
+    # AI Name
+    print("\n1. Name your AI")
+    print("What should the AI respond to? (e.g., Jarvis, Friday, or Hey AI)")
+    name = input(f"Enter name [Default: {cfg.wake_word}]: ").strip()
+    if name:
+        cfg.wake_word = name.lower()
+        
+    # Telegram
+    print("\n2. Telegram Notifications (Optional)")
+    print("Do you want to receive notifications on your phone when tasks are done?")
+    tg_choice = input("Enter y/n [Default: n]: ").strip().lower()
+    if tg_choice == 'y':
+        print("\n--- Telegram Setup Guide ---")
+        print("a. Open Telegram app and search for '@BotFather'")
+        print("b. Send '/newbot' and follow steps to get your HTTP API Token.")
+        cfg.telegram_bot_token = input("Paste your Bot Token here: ").strip()
+        
+        print("\nc. Now search for '@userinfobot' on Telegram and send '/start'.")
+        print("d. It will reply with your 'Id'.")
+        cfg.telegram_chat_id = input("Paste your ID here: ").strip()
+        print("----------------------------")
+    
+    cfg.save()
+    print("\n✅ Setup complete! Settings saved.\n")