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.
