alisa-assistant 1.0.0__tar.gz

alisa_assistant-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Swampod Sarkar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

alisa_assistant-1.0.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: alisa-assistant
+Version: 1.0.0
+Summary: ALISA — AI desktop assistant for Windows: voice, vision, system control, free AI chat
+Author: Swampod Sarkar
+License: MIT
+Keywords: ai-assistant,desktop-assistant,gemini,voice-assistant,windows-automation
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-generativeai
+Requires-Dist: pyttsx3
+Requires-Dist: SpeechRecognition
+Requires-Dist: screen-brightness-control
+Requires-Dist: pillow
+Requires-Dist: psutil
+Requires-Dist: opencv-python
+Requires-Dist: pytesseract
+Requires-Dist: pycaw; platform_system == "Windows"
+Requires-Dist: comtypes; platform_system == "Windows"
+Provides-Extra: audio
+Requires-Dist: PyAudio; extra == "audio"
+Dynamic: license-file
+
+# 💜 ALISA — AI Desktop Assistant for Windows
+
+Your own original desktop assistant: AI chat, voice, system control, app launching and notes — all in one dark futuristic dashboard.
+
+## ✨ Features
+
+- 💬 **AI chat** (OpenRouter FREE built-in, zero setup; Gemini optional)
+- 🧠 **Memory** (`remember/forget/what do you remember`) · 🔬 **Deep research** to file
+- 👁 **Camera vision** (`see`) · 🖥️ **Screen tools** (screenshot, OCR, minimize, lock)
+- 🔊 **Voice output** (offline) + 🎤 **mic input** (optional)
+- 💻 **System control**: volume up/down/mute, brightness 10–100, system info
+- 🚀 **Open/close apps & sites** · 🔍 **search/play/news** · 💬 **WhatsApp + contacts**
+- 📁 **File ops**: notes, folders, move, rename, delete, organize, find, file info, clipboard
+- 🌍 **Website scaffolder** (`website NAME [landing|blog|portfolio]`) + publish guide
+- ⏰ **Reminders** · 🔗 **command chaining** · 🌐 Bangla-friendly · 📊 status bar
+
+## 📦 Install (Windows)
+
+```bat
+cd D:\ALISA
+pip install -r requirements.txt
+```
+
+Minimum (AI chat + voice output only):
+
+```bat
+pip install google-generativeai pyttsx3
+```
+
+Extras:
+
+```bat
+pip install SpeechRecognition screen-brightness-control pycaw comtypes
+```
+
+Microphone on Windows needs PyAudio:
+
+```bat
+pip install pipwin && pipwin install pyaudio
+```
+
+## 🚀 Run
+
+```bat
+python main.py
+```
+
+## 🔑 Free Gemini API key (2 min)
+
+1. Go to **aistudio.google.com** → sign in → **Get API key**
+2. Open ALISA → **⚙ Settings** → paste key → Save
+3. Ask anything!
+
+## 📁 Structure
+
+```
+ALISA/
+├── main.py            → launcher (python main.py)
+├── requirements.txt
+├── config.json        → created on first save (your key, local only)
+└── alisa/
+    ├── gui.py         → dashboard window
+    ├── brain.py       → command parser + actions
+    ├── ai_client.py   → Gemini chat
+    ├── voice.py       → TTS + mic
+    ├── systemctl.py   → volume/brightness
+    └── config.py      → local settings
+```
+
+© 2026 ALISA · Original code, MIT License.

alisa_assistant-1.0.0/README.md

@@ -0,0 +1,70 @@
+# 💜 ALISA — AI Desktop Assistant for Windows
+
+Your own original desktop assistant: AI chat, voice, system control, app launching and notes — all in one dark futuristic dashboard.
+
+## ✨ Features
+
+- 💬 **AI chat** (OpenRouter FREE built-in, zero setup; Gemini optional)
+- 🧠 **Memory** (`remember/forget/what do you remember`) · 🔬 **Deep research** to file
+- 👁 **Camera vision** (`see`) · 🖥️ **Screen tools** (screenshot, OCR, minimize, lock)
+- 🔊 **Voice output** (offline) + 🎤 **mic input** (optional)
+- 💻 **System control**: volume up/down/mute, brightness 10–100, system info
+- 🚀 **Open/close apps & sites** · 🔍 **search/play/news** · 💬 **WhatsApp + contacts**
+- 📁 **File ops**: notes, folders, move, rename, delete, organize, find, file info, clipboard
+- 🌍 **Website scaffolder** (`website NAME [landing|blog|portfolio]`) + publish guide
+- ⏰ **Reminders** · 🔗 **command chaining** · 🌐 Bangla-friendly · 📊 status bar
+
+## 📦 Install (Windows)
+
+```bat
+cd D:\ALISA
+pip install -r requirements.txt
+```
+
+Minimum (AI chat + voice output only):
+
+```bat
+pip install google-generativeai pyttsx3
+```
+
+Extras:
+
+```bat
+pip install SpeechRecognition screen-brightness-control pycaw comtypes
+```
+
+Microphone on Windows needs PyAudio:
+
+```bat
+pip install pipwin && pipwin install pyaudio
+```
+
+## 🚀 Run
+
+```bat
+python main.py
+```
+
+## 🔑 Free Gemini API key (2 min)
+
+1. Go to **aistudio.google.com** → sign in → **Get API key**
+2. Open ALISA → **⚙ Settings** → paste key → Save
+3. Ask anything!
+
+## 📁 Structure
+
+```
+ALISA/
+├── main.py            → launcher (python main.py)
+├── requirements.txt
+├── config.json        → created on first save (your key, local only)
+└── alisa/
+    ├── gui.py         → dashboard window
+    ├── brain.py       → command parser + actions
+    ├── ai_client.py   → Gemini chat
+    ├── voice.py       → TTS + mic
+    ├── systemctl.py   → volume/brightness
+    └── config.py      → local settings
+```
+
+© 2026 ALISA · Original code, MIT License.

alisa_assistant-1.0.0/alisa/ai_client.py

@@ -0,0 +1,154 @@
+"""ALISA AI clients: Gemini (primary) + OpenRouter (fallback), text + vision."""
+
+import json
+import re
+import urllib.request
+
+try:
+    import google.generativeai as genai
+    _GENAI = True
+except Exception:
+    _GENAI = False
+
+SYSTEM_PROMPT = (
+    "You are ALISA, a friendly offline-first Windows desktop assistant. "
+    "Your creator is Swampod Sarkar — if anyone asks who made/created/developed you, "
+    "answer: Swampod Sarkar. "
+    "Answer briefly (under 80 words unless asked for detail). "
+    "You can open apps, control volume/brightness, search the web and save notes."
+)
+
+OPENROUTER_URL = "https://openrouter.ai/api/v1/chat/completions"
+OPENROUTER_MODEL = "nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free"
+OPENROUTER_VISION_MODEL = "inclusionai/ling-3.0-flash-vl:free"
+
+# Built-in free key so the app works out of the box (user can override in Settings).
+# ⚠️ If you publish this code publicly, regenerate the key at openrouter.ai/keys
+# and replace it — anyone reading the code can spend this key's quota.
+DEFAULT_OR_KEY = "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"
+
+
+def _assert_free(model):
+    if not model.endswith(":free"):
+        raise RuntimeError("Only free (:free) models are allowed in ALISA.")
+
+
+def clean_or_key(k):
+    """Extract a valid key, else '' (caller falls back to built-in key)."""
+    m = re.search(r"sk-or-v1-[A-Za-z0-9\-_]+", k or "")
+    return m.group(0) if m else ""
+
+
+class GeminiClient:
+    """Default: OpenRouter free models (no setup needed). Gemini = optional upgrade."""
+
+    def __init__(self, api_key="", or_key=""):
+        self.api_key = (api_key or "").strip()
+        self.or_key = clean_or_key(or_key) or DEFAULT_OR_KEY
+        self._model = None
+
+    @property
+    def ready(self):
+        return bool(self.or_key or (_GENAI and self.api_key))
+
+    @property
+    def provider(self):
+        if self.or_key:
+            return "OpenRouter-free"
+        if _GENAI and self.api_key:
+            return "Gemini"
+        return "off"
+
+    def _ensure(self):
+        if not _GENAI:
+            raise RuntimeError("Install the AI package: pip install google-generativeai")
+        if not self.api_key:
+            raise RuntimeError("No API key — add your free Gemini key in Settings.")
+        if self._model is None:
+            genai.configure(api_key=self.api_key)
+            self._model = genai.GenerativeModel(
+                "gemini-2.0-flash", system_instruction=SYSTEM_PROMPT
+            )
+        return self._model
+
+    def _with_facts(self, prompt, facts):
+        if facts:
+            return "Facts you remember about the user:\n- " + "\n- ".join(facts) + f"\n\nUser: {prompt}"
+        return prompt
+
+    def ask(self, prompt, history=None, facts=None):
+        # OpenRouter free models first (zero setup) → Gemini fallback.
+        if self.or_key:
+            try:
+                return self._ask_openrouter(prompt, facts, history)
+            except Exception as e:
+                if not (_GENAI and self.api_key):
+                    raise RuntimeError(f"AI error: {e}")
+        model = self._ensure()
+        chat = model.start_chat(history=history or [])
+        resp = chat.send_message(self._with_facts(prompt, facts))
+        return ((resp.text or "").strip()) or "(empty reply)"
+
+    def _ask_openrouter(self, prompt, facts=None, history=None):
+        if not self.or_key:
+            raise RuntimeError("AI error — check your API key in Settings.")
+        _assert_free(OPENROUTER_MODEL)
+        messages = [{"role": "system", "content": SYSTEM_PROMPT}]
+        if facts:
+            messages.append({"role": "system", "content": "Remembered facts: " + "; ".join(facts)})
+        for m in (history or [])[-6:]:
+            role = "assistant" if m.get("role") == "model" else "user"
+            parts = m.get("parts", [""])
+            messages.append({"role": role, "content": parts[0] if parts else ""})
+        messages.append({"role": "user", "content": prompt})
+        payload = json.dumps({"model": OPENROUTER_MODEL, "messages": messages}).encode()
+        req = urllib.request.Request(
+            OPENROUTER_URL, data=payload,
+            headers={"Authorization": f"Bearer {self.or_key}",
+                     "Content-Type": "application/json",
+                     "HTTP-Referer": "https://localhost/alisa",
+                     "X-Title": "ALISA Assistant"},
+        )
+        with urllib.request.urlopen(req, timeout=60) as r:
+            data = json.load(r)
+        return data["choices"][0]["message"]["content"].strip()
+
+    def describe_image(self, jpeg_bytes, prompt="Describe what you see briefly."):
+        """Vision: OpenRouter free vision model first, Gemini as fallback."""
+        if self.or_key:
+            try:
+                return self._describe_image_or(jpeg_bytes, prompt)
+            except Exception as e:
+                if not (_GENAI and self.api_key):
+                    raise RuntimeError(f"Vision error: {e}")
+        model = self._ensure()
+        resp = model.generate_content([
+            {"mime_type": "image/jpeg", "data": jpeg_bytes},
+            prompt,
+        ])
+        return (resp.text or "").strip() or "(could not describe image)"
+
+    def _describe_image_or(self, jpeg_bytes, prompt):
+        import base64
+        _assert_free(OPENROUTER_VISION_MODEL)
+        b64 = base64.b64encode(jpeg_bytes).decode()
+        payload = json.dumps({
+            "model": OPENROUTER_VISION_MODEL,
+            "messages": [{
+                "role": "user",
+                "content": [
+                    {"type": "text", "text": prompt},
+                    {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{b64}"}},
+                ],
+            }],
+        }).encode()
+        req = urllib.request.Request(
+            OPENROUTER_URL, data=payload,
+            headers={"Authorization": f"Bearer {self.or_key}",
+                     "Content-Type": "application/json",
+                     "HTTP-Referer": "https://localhost/alisa",
+                     "X-Title": "ALISA Assistant"},
+        )
+        with urllib.request.urlopen(req, timeout=90) as r:
+            data = json.load(r)
+        return data["choices"][0]["message"]["content"].strip()