project_info.md

# SHAXMAT AI MASLAHATCHI

**Professional shaxmat tahlili va strategik maslahatlar uchun sun'iy intellekt yordamchisi**

---

## QISQACHA MA'LUMOT

Shaxmat AI Maslahatchi - bu professional darajadagi shaxmat debyutlarini tahlil qilish va raqib strategiyalariga qarshi rejalar ishlab chiqish uchun mo'ljallangan AI-powered dastur. AI modelidan foydalangan holda, dastur sizning o'yin uslubingiz va repertuaringizga mos keladigan shaxsiylashtirilgan maslahatlar beradi.

### Asosiy Imkoniyatlar

- **Debyut Tahlili**: Raqib debyutlariga qarshi eng samarali strategiyalarni tahlil qilish
- **Shaxsiylashtirilgan Yondashuv**: Sizning mavjud repertuaringizni hisobga olgan tavsiyalar
- **Professional Maslahatlar**: Har bir debyut uchun batafsil strategik rejalar va tuzoqlar
- **Qulay Interfeys**: Gradio asosida yaratilgan intuitiv foydalanuvchi interfeysi
- **Real-vaqt Tahlil**: Tez va samarali natijalar

---

## ARXITEKTURA VA TEXNOLOGIYALAR

### Ishlatilgan Texnologiyalar

- **Python 3.8+**: Asosiy dasturlash tili
- **Google Gemini 2.5 Flash**: Sun'iy intellekt modeli
- **Gradio 4.x**: Web interfeys freymvorki
- **Google Generative AI SDK**: API integratsiyasi

### Tizim Talablari

```
Python: 3.8 yoki yuqori
Xotira: Minimum 2GB RAM
Internet: API chaqiruvlari uchun barqaror ulanish
Platforma: Windows, macOS, Linux
```

---

## O'RNATISH VA ISHGA TUSHIRISH

### 1-Qadam: Repozitoriyani Klonlash

```bash
git clone https://github.com/sizning-username/shaxmat-ai-maslahatchi.git
cd shaxmat-ai-maslahatchi
```

### 2-Qadam: Virtual Muhit Yaratish

```bash
# Virtual muhit yaratish
python -m venv venv

# Virtual muhitni faollashtirish
# Windows uchun:
venv\Scripts\activate

# macOS/Linux uchun:
source venv/bin/activate
```

### 3-Qadam: Kerakli Kutubxonalarni O'rnatish

```bash
pip install -r requirements.txt
```

**requirements.txt** fayli:
```
google-generativeai>=0.3.0
gradio>=4.0.0
python-dotenv>=1.0.0
```

### 4-Qadam: API Kalitini Sozlash

Google AI Studio orqali API kalitini oling:
1. [Google AI Studio](https://makersuite.google.com/app/apikey) ga kiring
2. Yangi API kaliti yarating
3. Kalitni `.env` faylida saqlang:

```bash
# .env fayli yaratish
echo "GOOGLE_API_KEY=sizning_api_kalitingiz" > .env
```

Yoki to'g'ridan-to'g'ri eksport qiling:
```bash
export GOOGLE_API_KEY='your_api_key'
```

### 5-Qadam: Dasturni Ishga Tushirish

```bash
python app.py
```

Dastur ishga tushgach, brauzeringizda quyidagi manzilni oching:
```
http://localhost:7860
```

---

## 💡 FOYDALANISH QO'LLANMASI

### Asosiy Ish Jarayoni

1. **Rangni Tanlash**
   - "Oq" yoki "Qora" rangini belgilang
   - Bu sizning o'yin pozitsiyangizni aniqlaydi

2. **Raqib Debyutlarini Kiritish**
   - Raqibingiz odatda qaysi debyutlarni o'ynashini yozing
   - Misol: "e4, d4, London tizimi"

3. **Repertuarni Kiritish (Ixtiyoriy)**
   - O'zingiz bilgan va afzal ko'rgan debyutlarni kiriting
   - Misol: "e4 ga qarshi Sicilian, d4 ga qarshi Grunfeld"

4. **Tahlil Qilish**
   - "Tahlil Qilish" tugmasini bosing
   - 5-10 soniya ichida batafsil tahlil oling

### Natija Formati

Har bir raqib debyuti uchun quyidagilar taqdim etiladi:

- **Qarshi Debyt**: Eng samarali qarshi strategiya
- **Asosiy G'oya**: Debyutning asosiy konsepsiyasi
- **Strategik Rejalar**: 3-5 ta aniq harakat rejasi
- **Muhim Yurishlar**: Ochilish yurishlari ketma-ketligi
- **Tuzoqlar va Ehtiyot Choralari**: Diqqat qilish kerak bo'lgan nuqtalar
- **Qo'shimcha Maslahatlar**: O'rganish va mashq qilish bo'yicha yo'l-yo'riq

---

## 📊 MISOL STSENARIY

### Kirish Ma'lumotlari

```
Rang: Qora
Raqib Debyutlari: e4, London tizimi, Italyan partiyasi
Sizning Repertuaringiz: e4 ga qarshi Sicilian mudofaasi, d4 ga qarshi Kings Indian
```

### Kutilgan Natija

Dastur har bir debyt uchun:
- Sizning repertuaringizga mos keladigan qarshi strategiyalarni taklif qiladi
- Sicilian mudofaasining qaysi variantini tanlash kerakligini tushuntiradi
- London tizimiga qarshi aniq rejalar beradi
- Italyan partiyasida qora rang bilan qanday o'ynash kerakligini ko'rsatadi

---

## 🔧 SOZLASH VA KONFIGURATSIYA

### Gemini Modelini O'zgartirish

`app.py` faylida model nomini o'zgartiring:

```python
# Tezroq natijalar uchun
model = genai.GenerativeModel('gemini-2.5-flash')

# Batafsil tahlil uchun
model = genai.GenerativeModel('gemini-2.0-pro')
```


## 📄 LITSENZIYA

```
MIT License

Copyright (c) 2025 Shaxmat AI Maslahatchi

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.
```