🤖 AzerAI - Ağıllı Səsli Asistan

AzerAI - AzStudio Dev tərəfindən hazırlanmış, Azərbaycan dilində danışan, həm danışıq qurabilən, həm də müxtəlif tapşırıqları yerinə yetirə bilən qabaqcul süni intellekt asistanı.

🌟 Xüsusiyyətlər

🎯 Əsas Qabiliyyətlər

• Səsli Danışıq: Azərbaycan dilində natural danışıq
• Tapşırıq İcrası: Komputer idarəetmə, fayl əməliyyatları, internet axtarışı, və daha çox
• Plugin Sistemi: Sonsuz genişlənmə imkanı
• Yaddaş: Öncəki söhbətləri xatırlayır
• Şəxsiyyət: Klassik xidmətçi (butler) xarakteri - nəzakətli və bir qədər zarafatcı

🏗️ Texnologiya

📋 Arxitektura

• LiveKit Platformu: Real-time səsli kommunikasiya
• Google AI: Güclü dil modeli
• Plugin Mühəndisliyi: Modulyar və genişlənəbilən struktur
• Python 3.11: Müasir və stabil proqramlaşdırma dili

🔧 Sistem Tələbləri

• Windows 10/11
• Python 3.11+
• İnternet bağlantısı
• 1 GB RAM

🚀 Quraşdırma

🚀 Çox Asan Quraşdırma (Bir kliklə)

# 1. Repozitoriyı klonla
git clone https://github.com/AzStudio-Dev/AzerAI.git
cd AzerAI

# 2. Quraşdırma üçün
install.bat başlat

# 3. Konfiqurasiya üçün
config.bat başlat

# 4. Başlat
start.bat

📦 Manual Quraşdırma

# 1. Repozitoriyı klonla
git clone https://github.com/AzStudio-Dev/AzerAI.git
cd AzerAI

# 2. Sanal mühiti yarat
python -m venv AzerAI
.\AzerAI\Scripts\activate

# 3. Kitabxanaları yüklə
pip install -r requirements.txt

# 4. Konfiqurasiya üçün
config.bat başlat

# 5. Başlat
start.bat

🔧 İdarəetmə Scriptləri

• install.bat - 🚀 Tam avtomatik quraşdırma
• uninstall.bat - 🗑️ Tam silmə
• update.bat - 🔄 Yeniləmə
• config.bat - ⚙️ Konfiqurasiya (API açarları)
• start.bat - ▶️ Proqramı başlat

⚙️ Konfiqurasiya

.env faylında API açarlarını təyin edin:

GOOGLE_API_KEY=sizin_google_api_anahtarınız
LIVEKIT_URL=wss://sizin_livekit_url
LIVEKIT_API_KEY=sizin_api_anahtarınız
LIVEKIT_API_SECRET=sizin_api_sirriniz

🔌 Plugin Sistemi

💡 Nədir?

Pluginlər AzerAI-nin imkanlarını genişləndirən kiçik proqram modullarıdır. Hər plugin müəyyən bir funksiyanı yerinə yetirir.

📁 Plugin Sistemi

🕐 Defolt Plugin (2 ədəd)

• Datetime: Tarix, saat məlumatları
• Reminder: Hatırlatma və xatırlatıcı sistemi

🚀 AzStudio Dev Tərəfindən Hazır Olan Pluginləri

🏠 Home Assistant Ev avtomatlaşdırma sistemi nəzarəti 🔧 Qur	🌐 Browser Veb səhifələri açmaq 🔧 Qur
🔍 Search Yandex axtarışı 🔧 Qur	📺 YouTube Video və mahnı axtarışı və açmaq 🔧 Qur
🖥️ Display Control Ekran parlaqlığı, səs səviyyəsi idarəsi 🔧 Qur	🖱️ Input Control Klaviatura, siçan idarəsi 🔧 Qur
💻 System CPU, RAM, batareya məlumatları 🔧 Qur	📁 File Management Faylları axtar, aç, idarə et 🔧 Qur
📦 Winget Proqram quraşdırma/silmə/yeniləmə 🔧 Qur	🎵 Media Musiqi, video nəzarəti 🔧 Qur
🎵 Music Finder Çalan mahnını tanı 🔧 Qur	📥 YouTube Downloader Video və mahnı yükləmə 🔧 Qur
🌤️ Weather Hava proqnozu 🔧 Qur	⏰ Reminder Hatırlatma və xatırlatıcı sistemi 🔧 Qur
📶 Speedtest İnternet sürəti testi 🔧 Qur	⏰ Datetime Tarix, saat məlumatları 🔧 Qur

🔨 Yeni Plugin Yaratmaq

📂 Struktur

plugins/yeni_plugin/
├── __init__.py      # Zəruri importlar
├── main.py          # Əsas funksiyalar
├── info.py          # Plugin haqqında məlumat
└── prompts.py       # Plugin təlimatları

💻 Nümunə Plugin

__init__.py:

from .main import yeni_funksiya
__all__ = ["yeni_funksiya"]

main.py:

from livekit.agents import function_tool, RunContext

@function_tool()
async def yeni_funksiya(
    context: RunContext,
    parametr: str
) -> str:
    """Yeni funksiya təsviri"""
    return f"Nəticə: {parametr}"

info.py:

PLUGIN_NAME = "Yeni Plugin"
PLUGIN_DESCRIPTION = "Pluginin təsviri"
PLUGIN_AUTHOR = "Sizin Adınız"
PLUGIN_VERSION = "1.0.0"
PLUGIN_CATEGORY = "general"

prompts.py:

PLUGIN_INSTRUCTION = """
## Yeni Plugin İstifadəsi
İstifadəçilər X haqqında soruşduqda:
- yeni_funksiya funksiyasını Y parametri ilə istifadə et
"""

🎯 İstifadə Nümunələri

💬 Danışıq Nümunələri

İstifadəçi: "YouTube-də mahnı aç." AzerAI: "Sizin üçün YouTube-də yeni mahnı açıram."

İstifadəçi: "Bugün Bakıda hava necədir?" AzerAI: "Bakıda bu gün hava açıq, temperatur 25 dərəcədir."

İstifadəçi: "1 saat sonra bana xatırlat, toplantım var." AzerAI: "1 saat sonra toplantınız olduğunu xatırladacam."

İstifadəçi: "Sənədlərimi göstər." AzerAI: "Sənədlər qovluğunuzdakı faylları sizə göstərirəm."

İstifadəçi: "Parlaqlığı azalt." AzerAI: "Ekran parlaqlığı azaldılır."

İstifadəçi: "Musiqini dayandır." AzerAI: "Musiqi dayandırıldı."

İstifadəçi: "Yeni qovluq yarat." AzerAI: "Yeni qovluqun adını deyin."

İstifadəçi: "Yandex-də axtar." AzerAI: "Nə axtarmaq istədiyinizi deyin."

İstifadəçi: "Proqram quraşdır." AzerAI: "Hansı proqramı quraşdırmaq istəyirsiniz?"

İstifadəçi: "İnternet sürətini yoxla." AzerAI: "İnternet sürət testi başladılır."

İstifadəçi: "Xatırlatmaları göstər." AzerAI: "Aktiv xatırlatmalarınız göstərilir."

🔧 Əmrlər

🖱️ Sistem Nəzarəti

• "Parlaqlığı artır" → display_control plugin
• "Musiqini dayandır" → media plugin

📂 Fayl Əməliyyatları

• "Sənədləri aç" → file_management plugin
• "Yeni qovluq yarat" → file_management plugin
• "Proqram quraşdır" → winget plugin

🌐 İnternet

• "Yandex-də axtar" → search plugin
• "YouTube-da video yüklə" → youtube_downloader plugin
• "Havayı öyrən" → weather plugin

⏰ Hatırlatmalar

• "1 saat sonra xatırlat" → reminder plugin
• "Hər gün 10:00-da xatırlat" → reminder plugin
• "Xatırlatmaları göstər" → reminder plugin

👥 İstifadəçilər Üçün

👶 Uşaqlar

• Sadə və anlaşılır danışıq
• Təhlükəsiz və nəzarətli istifadə
• Oyun və öyrənmə dəstəyi

‍💼 Gündəlik İstifadəçilər

• İş avtomatlaşdırma
• Sürətli məlumat axtarışı
• Cron sistemi ilə vaxtla bağlı xatırlatmalar

🔧 Geliştiriciler Üçün

👨‍💻 Plugin Geliştirme

📋 Addımlar

1. Yeni plugin qovluğu yarat
2. 4 faylı yarat (init.py, main.py, info.py, prompts.py)
3. Funksiyaları @function_tool() ilə işarələ
4. Plugin avtomatik yüklənəcək

🎯 Ən Yaxşı Praktikalar

• Funksiyaların ilk parametri context: RunContext olmalıdır
• Təsvirli dökumentasiya yazın
• Xəta idarəsi əlavə edin
• Testlər yazın

🔍 Test Etmək

from plugins import get_all_tools, get_plugin_info

# Bütün alətləri yoxla
tools = get_all_tools()
print(f"Yüklənmiş {len(tools)} alət")

# Plugin məlumatlarını yoxla
info = get_plugin_info()
for name, data in info.items():
    print(f"{name}: {data['description']}")

🌟 Xüsusiyyətlər

• ✅ Avtomatik plugin kəşfi
• ✅ Dinamik alət yükləmə
• ✅ Plugin prompt inteqrasiyası
• ✅ Metadata idarəsi
• ✅ Geri qaytarılabilən uyğunluq
• ✅ Xəta idarəsi
• ✅ Debug dəstəyi

🔒 Təhlükəsizlik

🛡️ Məlumat Mühafizəsi

• Yerli yaddaş (şəxsi məlumatlar buludda saxlanılmır)
• Konfiqurasiyalı API açarları
• Plugin təhlükəsizliyi

👤 Məxfilik

• Söhbət tarixi yerli faylda saxlanılır
• İstifadəçi məlumatları paylaşılmır
• Şəxsi konfiqurasiya imkanı

🤝 Kömək və Dəstək

📞 Əlaqə

• GitHub: https://github.com/AzStudio-Dev
• GitHub Issues: Problemləri bildirin
• GitHub Discussions: Suallarınızı paylaşın

📚 Sənədlər

• Plugin Geliştirme Rehberi
• API Referans
• Tez-tez Soruşulan Suallar

🌈 Gələcək Planlar

🚀 Yeni Xüsusiyyətlər

• Mobil tətbiq dəstəyi
• Daha çox dil dəstəyi
• Bulud yaddaş seçimi
• Qabaqcıl AI inteqrasiyası

🔌 Gələcək Pluginlər

• Sosial media inteqrasiyası
• Tərcümə xidmətləri
• Oyun inteqrasiyası

📄 Lisenziya

Bu layihə MIT lisenziyası altında yayımlanır. Daha çox məlumat üçün LICENSE faylına baxın.

🙏 Təşəkkürlər

• LiveKit Team - Real-time kommunikasiya platforması
• Google AI - Güclü dil modelləri
• Azərbaycan İCM - Dil dəstəyi və testlər
• Açıq Mənbəli Cəmiyyət - Dəstək və töhfələr

---

AzerAI - Azərbaycanın ilk ağıllı səsli asistanı! 🇦🇿

Hər kəs üçün, hər yerdə, hər zaman!

---

📄 Müəllif Hüquqları

Layihə Müəllifi: AzStudio Dev

İl: 2026

Lisenziya: MIT License

AzStudio Dev tərəfindən hazırlanmışdır.