Képgenerátor Aréna

🚀 Áttekintés

A Képgenerátor Aréna egy web-alapú alkalmazás, amely lehetővé teszi különböző AI képgenerátorok által létrehozott képek összehasonlítását és értékelését. A rendszer négy fő módot kínál:

Arena Battle: Két kép közvetlen összehasonlítása, ahol a felhasználók a jobbnak ítélt képre szavazhatnak
Side-by-Side: Két kiválasztott modell képeinek összehasonlítása egymás mellett
Leaderboard: A modellek ranglistája az ELO pontszámok és egyéb statisztikák alapján
ELO Fejlődés: Grafikon, amely az egyes modellek ELO pontszámának időbeli változását mutatja

✨ Funkciók

🏆 ELO Rating: Fejlett pontrendszer, amely figyelembe veszi az ellenfelek erősségét
🖼️ Több formátum támogatása: JPG, JPEG, PNG és WEBP
⚙️ Konfigurálhatóság: Modellek, fájlformátumok és alapbeállítások külön konfigurációs fájlban
👁️‍🗨️ Vak szavazás: Arena Battle módban a modellek nevei csak a szavazás után jelennek meg
📊 Részletes statisztikák: ELO pontszámok, győzelmek, mérkőzések száma és győzelmi arányok
🔍 Modell típus szűrés: Leaderboard nézeten szűrhetők a modellek open source/zárt forrás szerint

🛠️ Telepítés

Követelmények

Python 3.6+
pip (Python csomagkezelő)
Git (opcionális)

Telepítési lépések

# 1. Klónozd vagy töltsd le a repository-t
git clone https://github.com/yourusername/image-leaderboard.git
cd image-leaderboard

# 2. Függőségek telepítése
pip install -r requirements.txt

# 3. Adatbázis inicializálása
python database.py

# 4. Alkalmazás indítása
flask run --host=0.0.0.0

# Az alkalmazás alapértelmezetten a következő címen érhető el:
# http://localhost:5000

📋 Használat

1. Arena Battle

Az Arena Battle a rendszer fő módja, ahol két véletlenszerűen kiválasztott modell által generált kép jelenik meg egymás mellett. A felhasználók kiválaszthatják, melyik kép tetszik jobban, vagy döntetlen/kihagyás opciót választhatnak.

A modellek nevei csak a szavazás után jelennek meg, így biztosítva az elfogulatlan értékelést.

2. Side-by-Side

A Side-by-Side módban a felhasználók maguk választhatják ki, melyik két modellt szeretnék összehasonlítani. Ez a mód elsősorban vizuális összehasonlításra szolgál, nincs szavazás.

3. Leaderboard

A Leaderboard a modellek ranglistáját mutatja ELO pontszám szerint csökkenő sorrendben. A táblázat tartalmazza az ELO értékeket, a győzelmek számát, az összes mérkőzés számát és a győzelmi arányt.

4. ELO Fejlődés

Az ELO Fejlődés nézet egy interaktív vonaldiagramot kínál, amely megjeleníti a modellek ELO pontszámának változását az idő múlásával. Ez lehetővé teszi a felhasználók számára, hogy nyomon kövessék, hogyan teljesítenek a modellek hosszabb időtávon.

Főbb jellemzők:

Minden modellhez külön színezett vonal
Interaktív információs dobozok a pontos értékek megjelenítésére
Időalapú x-tengely a fejlődés kronológiai nyomon követéséhez
Frissítési lehetőség a legfrissebb adatok betöltéséhez
Új interaktív funkció: ha az egeret lenyomva tartjuk a legendában egy modell nevére vagy jelölőjére, a többi modell grafikonja és jelölői 10%-os átlátszóságúvá halványulnak, felengedéskor visszaáll az eredeti állapot

⚙️ Parancssori funkciók

Szavazatok resetelése

python app.py reset-votes

Ez a parancs törli az összes eddigi szavazatot és visszaállítja az ELO pontszámokat az alapértelmezett értékre. Ezt akkor érdemes használni, ha:

Teljesen új versenyt akarsz indítani
Tesztadatok után szeretnéd az éles adatgyűjtést elkezdeni
Problémás szavazatok kerültek a rendszerbe

Fontos: A parancs az elo_history tábla tartalmát is törli, így a grafikon is tiszta lappal indul újra. Az ELO fejlődés grafikonon minden modell újra az alapértelmezett ELO pontszámról (1500) fog indulni.

📁 Rugalmas fájlkezelés

A rendszer képes rugalmasan kezelni a képfájlok kiterjesztéseit. Ez azt jelenti, hogy:

✅ Ugyanazon modell képei különböző kiterjesztésekkel szerepelhetnek különböző prompt mappákban
✅ Támogatott kiterjesztések: .jpg, .jpeg, .png, .webp
⚠️ A fájlnév alaprésze (kiterjesztés nélkül) mindig meg kell hogy egyezzen a konfigurációban beállítottal

Példa konfiguráció:

# Modell nevek és a hozzájuk tartozó adatok
# Minden modell egy szótár, ami tartalmazza:
# - 'filename': A fájlnév alaprésze kiterjesztés nélkül
# - 'open_source': Boolean érték, True ha letölthető/open source modell, False ha zárt/nem letölthető
MODELS = {
    'model-001': {'name': 'Grok', 'filename': 'grok', 'open_source': False},
    'model-002': {'name': 'Google Gemini Flash 2.0', 'filename': 'gemini-flash', 'open_source': False},
    'model-003': {'name': 'Google Imagen 3', 'filename': 'imagen3', 'open_source': False},
    # ... további modellek a config.py alapján ...
}

🌟 Jelenleg támogatott modellek

Grok
Google Gemini Flash 2.0
Google Imagen 3
GPT Image 1
Midjourney v6.1
Midjourney v7
Midjourney v7 20250501
Reve
HiDream-I1
Lumina-Image-2.0
Capcut Dreamina Image 2.0 Pro
Juggernaut XI
Fluxmania V
Tengr.ai
Tengr.ai Quantum
Adobe Firefly Image 4
Dreamina Seedream 3.0
Ideogram 3.0
Piclumen Realistic V2
F Lite Standard
Google Gemini Flash 2.0 Preview 0507
Tencent Hunyuan Image 2.0
Google Imagen 4
Recraft V3 Raw
ByteDance BAGEL
FLUX.1 Kontext [pro]
Chroma v34
Ernie 4.5 Turbo
Google Imagen 4 Ultra
Qwen-Image
Gemini 2.5 Flash Image Preview
FLUX.1 Krea
Tencent Hunyuan Image 2.1
ByteDance Seedream 4.0 4k
Kling AI KOLORS 2.1
Tencent HunyuanImage-3.0
OpenAI: GPT-5 Image Mini High
OpenAI: GPT-5 Image Mini Low
OpenAI: GPT-5 Image Mini Medium
Microsoft: MAI-Image-1

🗄️ Adatbázis struktúra

A rendszer három fő táblát használ:

votes - A felhasználói szavazatok tárolására

CREATE TABLE votes (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    prompt_id TEXT NOT NULL,
    winner TEXT NOT NULL, -- Modell azonosító (pl. 'model-001')
    loser TEXT NOT NULL,  -- Modell azonosító (pl. 'model-002')
    voted_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

model_elo - A modellek aktuális ELO pontszámainak tárolására

CREATE TABLE model_elo (
    model TEXT PRIMARY KEY, -- Modell azonosító (pl. 'model-001')
    elo REAL NOT NULL,
    last_updated TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

elo_history - Az ELO pontszámok változásának történeti nyomon követésére

CREATE TABLE elo_history (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    model TEXT NOT NULL, -- Modell azonosító (pl. 'model-001')
    elo REAL NOT NULL,
    timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

🔌 API végpontok

A rendszer a következő API végpontokat biztosítja:

Végpont	Metódus	Leírás
`/`	GET	A főoldal megjelenítése.
`/images/<prompt_id>/<filename>`	GET	Képfájlok kiszolgálása a `data` mappából.
`/api/battle_data`	GET	Adatokat ad vissza az Arena Battle módhoz (prompt, két véletlenszerű modell képei és nevei).
`/api/side_by_side_data`	GET	Adatokat ad vissza a Side-by-Side módhoz (prompt, két kiválasztott modell képei és nevei).
`/api/get_image`	GET	Visszaadja egy adott modell képének URL-jét egy adott prompt ID-hoz (Side-by-Side módhoz használt).
`/api/vote`	POST	Rögzíti a felhasználó szavazatát (győztes, vesztes) és frissíti az ELO értékeket.
`/api/leaderboard`	GET	Visszaadja az aktuális Leaderboard adatokat (modellek neve, ELO, győzelmek, meccsek, győzelmi arány, open source státusz).
`/api/elo_history`	GET	(Elavult lehet) Visszaadja az ELO értékek időbeli változásait a modellek grafikonos megjelenítéséhez.
`/api/elo_history_with_current_elo`	GET	Visszaadja az ELO értékek időbeli változásait (`history`) és az aktuális ELO pontszámokat (`current_elos`) a grafikonhoz és szűréshez.
`/api/prompt_ids`	GET	Visszaadja az összes elérhető prompt ID-t.
`/api/prompt_text`	GET	Visszaadja a prompt szövegét egy adott prompt_id-hoz.

📝 Licenc

MIT

📚 További dokumentáció

A részletes dokumentáció a docs/index.html fájlban található.

icebob/Leaderboard-Image