---
title: KIA Command Center
emoji: 🛡️
colorFrom: red
colorTo: blue
sdk: docker
pinned: false
app_port: 7860
short_description: Albanian General Staff Military AI Assistant
---

# 🛡️ KIA Command Center — v3.0

**Komanda e Inteligjencës Artificiale i Shtabit të Përgjithshëm**
*Forcat e Armatosura të Republikës së Shqipërisë*

> Asistenti AI i parë institucional i specializuar për komandën ushtarake shqiptare — me 4 nivele aksesi, RAG hibrid, OCR, STT/TTS, dhe ndërfaqe profesionale C4ISR.

![Classification](https://img.shields.io/badge/Klasifikimi-I%20PAKLASIFIKUAR-green)
![Version](https://img.shields.io/badge/Version-3.0.0-blue)
![Model](https://img.shields.io/badge/Model-Qwen--72B-orange)
![Framework](https://img.shields.io/badge/Framework-FastAPI%20+%20Vite-purple)

---

## ⚡ Kapacitetet Kryesore

### 🔐 Sistemi Multi-Rol (4 Nivele Aksesi)
| Rol | Klasifikimi | Aksesi |
|-----|-------------|--------|
| **Vizitor** | 🟢 I PAKLASIFIKUAR | Informacion publik |
| **Oficer** | 🟡 I KUFIZUAR | Operacional i përgjithshëm |
| **Komandant** | 🟠 KONFIDENCIAL | Plane strategjike |
| **Gjeneral** | 🔴 SEKRET | Akses i plotë strategjik |

- Çdo rol ka sistem prompt unik, suggestions specifike, dhe UI klasifikimi
- Classification badge në çdo mesazh
- Greeting personal sipas rangut

### 🧠 RAG Engine Hibrid
- **ChromaDB** — Kërkim semantik vektorial me `all-MiniLM-L6-v2`
- **BM25** — Lexical ranking si complement/fallback
- **14,000+ dokumente** nga burime zyrtare (MOD, AAF, NATO, Wikipedia)
- **41 Gold Facts** — Fakte të verifikuara me prioritet absolut
- **Source Priority**: Gold > MOD/AAF (0.95) > NATO (0.90) > Wiki (0.70)
- **Recency Boost**: Informacione 2025-2026 marrin 30% bonus

### 🎤 Multimodal (Zë + Dokument)
- **STT**: Whisper — transkriptim i urdhrave në shqip
- **TTS**: Edge-TTS — përgjigje zanore automatike
- **OCR**: Tesseract + pdfplumber — skanim PDF, DOCX, XLSX, imazhe
- **Auto-suggest**: Pas OCR, ofron pyetje kontekstuale mbi dokumentin

### 🗺️ Ndërfaqe C4ISR Profesionale
- **Dashboard** me metrika të animuara (count-up) dhe sparkline charts
- **Hartë Operative** Leaflet me baza ushtarake dhe misione NATO
- **Organigram** interaktiv — klikoni për pyetje mbi çdo departament
- **PDF Export** i formatuar si raport klasifikuar i inteligjencës
- **Keyboard Shortcuts** (F1) — navigim profesional

### 🔒 Siguria (OPSEC)
- Prompt injection protection (7+ patterna)
- Refuzim i pyetjeve të ndjeshme (armë, kodet, ORBAT)
- Rate limiting (10 req/min per IP)
- Session memory me TTL 30 min

---

## 🏗️ Arkitektura

```
┌─────────────────────────────────────────────────────┐
│                    Frontend (Vite)                    │
│  ┌──────────┐  ┌──────┐  ┌──────┐  ┌────────────┐  │
│  │Role Login│  │ Chat │  │ Map  │  │ Dashboard  │  │
│  └──────────┘  └──────┘  └──────┘  └────────────┘  │
│  ┌──────────┐  ┌──────┐  ┌──────────────────────┐  │
│  │Org Chart │  │ Docs │  │ Intel Panel (Right)  │  │
│  └──────────┘  └──────┘  └──────────────────────┘  │
└──────────────────────┬──────────────────────────────┘
                       │ API
┌──────────────────────┴──────────────────────────────┐
│                Backend (FastAPI)                      │
│  ┌──────┐  ┌──────┐  ┌──────┐  ┌────────────────┐  │
│  │ Chat │  │ STT  │  │ TTS  │  │   OCR Scanner  │  │
│  └──┬───┘  └──────┘  └──────┘  └────────────────┘  │
│     │                                                │
│  ┌──┴───────────────────────────────────────────┐   │
│  │          Hybrid RAG Engine                    │   │
│  │  ┌────────┐  ┌────────┐  ┌──────────────┐   │   │
│  │  │ChromaDB│  │  BM25  │  │  Gold Facts  │   │   │
│  │  └────────┘  └────────┘  └──────────────┘   │   │
│  └──────────────────────────────────────────────┘   │
│     │                                                │
│  ┌──┴──────────┐                                    │
│  │ Qwen-72B    │  (Hugging Face Inference API)      │
│  └─────────────┘                                    │
└─────────────────────────────────────────────────────┘
```

---

## 🚀 Setup & Deployment

### Lokal
```bash
# Backend
pip install -r requirements-space.txt
uvicorn app.api:app --port 8001

# Frontend
cd frontend && npm install && npm run dev
```

### Docker (Hugging Face Spaces)
```bash
docker build -t kia .
docker run -e HF_TOKEN=your_token -p 7860:7860 kia
```

### Data Pipeline
```bash
python main.py all  # Scrape → Clean → Build Dataset → Upload to HF
```

---

## 📁 Struktura e Projektit

```
KIA/
├── app/
│   ├── api.py           # FastAPI endpoints + multi-role system
│   ├── rag.py           # Hybrid RAG engine (ChromaDB + BM25)
│   ├── ocr.py           # Document scanner (PDF, DOCX, images)
│   ├── stt.py           # Speech-to-text (Whisper)
│   └── tts.py           # Text-to-speech (Edge-TTS)
├── frontend/
│   ├── index.html       # SPA with role selection + tactical HUD
│   └── src/
│       ├── main.js      # App logic, multi-role, streaming, animations
│       └── style.css    # NATO C4ISR design system
├── scraper/             # Web scraping pipeline
├── processing/          # Data cleaning + dataset builder
├── finetune/            # QLoRA fine-tuning scripts
├── data/
│   ├── gold/            # Verified critical facts (41 entries)
│   ├── dataset/         # Train/validation JSONL (~28MB)
│   └── chroma_db/       # Vector store
├── Dockerfile           # Multi-stage build
└── main.py              # Pipeline orchestrator
```

---

## 🎖️ Teknologjitë

| Komponent | Teknologji |
|-----------|------------|
| Model AI | Qwen2.5-72B-Instruct (via HF inference) |
| Embeddings | all-MiniLM-L6-v2 (Sentence Transformers) |
| Vector DB | ChromaDB |
| Keyword Search | BM25 (rank_bm25) |
| Backend | FastAPI + Uvicorn |
| Frontend | Vite + Vanilla JS |
| STT | OpenAI Whisper |
| TTS | Edge-TTS (Albanian) |
| OCR | Tesseract + pdfplumber |
| Maps | Leaflet.js |
| Container | Docker (multi-stage) |

---

## 📄 Licenca

Zhvilluar për përdorim institucional — Shtabi i Përgjithshëm i FA-së.

---

*Zhvilluar me krenarinë shqiptare 🇦🇱 — KIA v3.0 Multi-Role Edition*