Metadata-Version: 2.4
Name: azerai
Version: 5.0.0
Summary: **AzerAI** - Azərbaycan Dilində Qabaqcıl Səsli AI Asistent
Author-email: AzerStudio Dev <Info.AzerStudioDev@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/AzerStudio-Dev/AzerAI
Project-URL: Repository, https://github.com/AzerStudio-Dev/AzerAI.git
Project-URL: Bug Tracker, https://github.com/AzerStudio-Dev/AzerAI/issues
Keywords: azerai,plugins,ai,azerbaijani,real-time,voice,assistant,python,livekit,google,openai
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Operating System :: MacOS :: MacOS X
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: livekit
Requires-Dist: livekit-agents
Requires-Dist: livekit-plugins-silero
Requires-Dist: livekit-plugins-noise-cancellation
Requires-Dist: livekit-plugins-google
Requires-Dist: livekit-plugins-openai
Requires-Dist: python-dotenv
Provides-Extra: plugins
Requires-Dist: AzerAI-Plugins-DateTime; extra == "plugins"
Requires-Dist: AzerAI-Plugins-Reminder; extra == "plugins"
Requires-Dist: AzerAI-Plugins-Search; extra == "plugins"
Dynamic: license-file

# 🤖 AzerAI

**AzerAI** - Azərbaycan dilində qabaqcıl səsli AI Asistent
plugin əsaslı, çoxdilli AI asistent framework

## 🌟 Xüsusiyyətlər

- 🎤 **Səsli interfeys** - Real-time səsli danışıq
- 🇦🇿 **Azərbaycan dili** - Əsas dil Azərbaycan dilidir
- 🔌 **Plugin sistemi** - Genişlənəbilən plugin arxitekturası
- 💾 **Yaddaş** - Söhbət tarixçəsi və context
- 🎭 **Şəxsiyyət** - Dostlu və əyləncəli xarakter
- 🌍 **Çoxdilli** - 50+ dil dəstəyi
- 🚀 **Yüksək performans** - LiveKit ilə real-time əməliyyatlar

## Platform Dəstəyi

- 💻 **Windows** - Windows 10/11 dəstəklənir
- 🍎 **macOS** - macOS 10.15+ dəstəklənir  
- 🐧 **Linux** - Ubuntu, CentOS, Debian dəstəklənir
- 🐍 **Python** - Python 3.8+ tələb olunur

## 🚀 Quraşdırma

### Əsas quraşdırma
```bash
pip install AzerAI
```

### Bütün pluginlərlə birlikdə
```bash
pip install AzerAI[plugins]
```

### Əl ilə quraşdırma
```bash
git clone https://github.com/AzerStudio-Dev/AzerAI.git
cd AzerAI
pip install -e .
```

## ⚙️ Konfiqurasiya

`.env` faylı yaradın:
```env
# LiveKit Konfiqurasiyası
LIVEKIT_API_KEY=your_api_key
LIVEKIT_API_SECRET=your_api_secret
LIVEKIT_URL=wss://your-livekit-server.com

# AI Model API Açarı Parametrləri
GOOGLE_API_KEY=your_google_api_key
OPENAI_API_KEY=your_openai_api_key

# AI Model Seçimi (google və ya openai)
AI_PROVIDER=google
```

## 🎯 İstifadə

### Console modu
```bash
AzerAI console           # Konsol modunda işlə
```

### Digər əmrlər
```bash
AzerAI start             # Serveri başlad
```
```bash
AzerAI dev               # İnkişaf rejimi
```
```bash
AzerAI connect           # Qoşul
```
```bash
AzerAI download-files    # Faylları yüklə
```

## 🔌 Plugin Yaratmaq

Yeni plugin yaratmaq üçün ətraflı təlimata baxın:

📖 **[Plugin Yaratma və Yayımlama Təlimatı](https://github.com/AzerStudio-Dev/AzerAI/blob/main/PLUGIN_GUIDE.md)**

> **Sürətli Başlanğıc:**
> - Plugin adı `azerai-plugins-` prefiksi ilə başlamalıdır
> - Bütün funksiyalar `@function_tool()` dekoratoru ilə işarələnməlidir
> - Hər plugin `__init__.py`, `info.py`, `main.py`, `prompts.py` fayllarına malik olmalıdır
> - `ctx: RunContext` parametri hər funksiyada olmalıdır
> - Azərbaycan dilində təsvirlər istifadə edin
> - Funksiyalar `async` olmalıdır
> - Ətraflı təlimat üçün yuxarıdakı linkə klikləyin

## 🤝 İştirak

1. Fork edin
2. Feature branch yaradın (`git checkout -b feature/amazing-feature`)
3. Commit edin (`git commit -m 'Add amazing feature'`)
4. Push edin (`git push origin feature/amazing-feature`)
5. Pull Request yaradın

## 📄 Lisenziya

Bu layihə MIT Lisenziyası ilə lisenziyalaşdırılıb - [LICENSE](https://github.com/AzerStudio-Dev/AzerAI/blob/main/LICENSE) faylına baxın.

## 🙏 Təşəkkürlər

- [Python](https://python.org/) - Proqramlaşdırma dili
- [LiveKit](https://livekit.io/) - Real-time audio/video framework
- [Google](https://ai.google.dev/) - AI modeli
- [OpenAI](https://openai.com/) - AI modeli
- Azərbaycan icması - Dəstək və tövsiyələr

## 📞 Əlaqə

- **Müəllif:** AzerStudio Dev
- **Email:** Info.AzerStudioDev@gmail.com
- **GitHub:** https://github.com/AzerStudio-Dev/AzerAI
- **PyPI:** https://pypi.org/project/AzerAI/

---

**🇦🇿 Azərbaycanın ilk tam plugin ekosistemli AI asistenti!** 🚀
