Home
Üdvözöljük a Face-Local dokumentációjában! Ez egy offline arcfelismerő és személyazonosító alkalmazás, amely helyi adatbázisban tárolt képeket elemez, arcokat felismer és automatikusan személyekre csoportosítja.
Face-Local lehetővé teszi, hogy:
- Képkönyvtárat beszkennelj — az alkalmazás rekurzívan megkeresi az összes képfájlt
- Arcokat felismerj — automatikus arc detekció GPU vagy CPU-n
- Személyeket azonosíts — arcokból AI-alapú arcembedding-ek generálása
- Arcokat csoportosíts — hasonló arcok automatikus felismerése és csoportosítása
- Személyeket név szerint kezelj — csoportokat átnevezés, összevonás, javítás
- Galériákat böngéssz — képek megtekintése, arcok szerkesztése
- Adatokat exportálj — CSV, JSON, HTML galéria, kollázsok
- Google Drive-ot használj — Képek feldolgozása a felhőről
Fontos: Az alkalmazás teljesen offline működik, nem küld adatot a felhőbe. Minden feldolgozás a saját számítógépeden történik.
| Témakör | Leírás |
|---|---|
| 🚀 Első Lépések | Gyors útmutató az induláshoz — mindössze 12 lépésben |
| 📦 Telepítés & Beállítások | Részletes telepítési útmutató, modell letöltése, GPU/CPU beállítás |
| 🖥️ Kezelőfelület | Az alkalmazás UI komponenseiről, paneljeiről, toolbarok |
| 🧠 Arcfelismerés | Az arc detekció és beágyazás folyamata, hogyan működik az AI |
| 👥 Személyek Kezelése | Személynevek, összevonás, javítás, hozzárendelés |
| 🎯 BBox Szerkesztés | Bounding box-ok módosítása, arc manuális korrekciója |
| 📸 Képböngésző | Képmappák böngészése, arcok megtekintése képekhez |
| 🎨 Kollázs Készítés | Picasa-stílusú kollázsok, exportálás |
| 🔍 Keresés & Szűrés | Személyek keresése, képek szűrése |
| 📤 Export & Megosztás | CSV, JSON, HTML galéria, képek exportálása |
| 🌐 Google Drive Integráció | Képek Google Drive-ról, szinkronizálás |
| ⚙️ Beállítások | Az alkalmazás konfigurálása, preferenciak |
| ⌨️ Gyorsbillentyűk | Keyboard shortcuts az alkalmazásban |
| ❓ Gyakori Problémák | Hibakezelés, elhárítás |
| 💡 Tippek & Trükkök | Haladó technikák, best practices |
1. Képmappa kiválasztása (anyukám fotóalbuma)
2. Arcok felismertetése (▶ Start)
3. Személyeket átnevezése (Nagymama, Nagyapa, stb.)
4. Téves összepárosítások korrigálása
5. HTML galéria exportálása a családnak
1. Esemény mappája kiválasztása
2. Arcfelismerés futtatása
3. "Ismeretlen" csoport átvizsgálása
4. Szükséges arcok kézi hozzárendelése
5. CSV export a résztvevőkkel
1. Az éves archívum megnyitása
2. Szerkesztett képek újrafeldolgozása
3. Személyek listájának frissítése
4. Duplikátumok eltávolítása
5. Biztonsági mentés az adatbázisról
| Funkció | Face-Local | Felhő (Google Photos, stb.) |
|---|---|---|
| Adatvédelem | ✅ Minden helyen | ❌ Szerveren |
| Internet | ❌ Nem szükséges | ✅ Szükséges |
| Sebesség | ✅ GPU gyorsításakor | |
| Költség | ✅ Ingyenes | ❌ Felhasználások után díjas |
| Offline | ✅ Teljes offline | ❌ Korlátozott |
| Saját Kontroll | ✅ Teljes |
- Python 3.11+
- pip csomagkezelő
- Választható: Google Coral USB Accelerator gyorsabb feldolgozáshoz
# Repository klónozása
git clone <repo-url>
cd face-local
# Virtuális environment létrehozása
python3.11 -m venv .venv
source .venv/bin/activate # macOS/Linux
# vagy:
.venv\Scripts\activate # Windows
# Függőségek telepítése
pip install -r requirements.txt
# Konfiguráció másolása
cp config.example.yaml config.yamlpython -m app.main- Keretrendszer: PySide6 (Qt Python binding)
- Arc Detekció: OpenCV (CPU) / Google Coral (GPU)
- Arc Beágyazás: MobileFaceNet TFLite (CPU csak)
- Csoportosítás: DBSCAN algoritmus
- Adatbázis: SQLAlchemy ORM + SQLite
- Modell: Google Coral Edge TPU (opcionális)
- Kezdj az Első Lépésekkel — Gyors útmutató
- Nézd meg a Kezelőfelület — UI komponensek megismerése
- Olvass Gyakori Problémák-ot — Hibaelhárítás
- Tanúsítsd meg a Tippek & Trükkök-ot — Haladó technikák
- Kezdőoldal (te vagy itt! 👈)
- Első Lépések
- Telepítés
- Kezelőfelület
A legjobb módja az alkalmazás megismerésének a kipróbálása. Kattints az alábbi gombra és kezdj el!
- Alkalmazás: Face-Local v0.1.60+
- Dokumentáció: Teljes user guide 2026. június
- Nyelvek: Magyar, English
- Licence: MIT (open source)
A projekthez a GitHub repository-ből tudod követni és hozzájárulni:
- GitHub Issues: Problémák bejelentése
- Pull Requests: Fejlesztések hozzájárulása
- Dokumentáció: A wiki-t fejleszteni lehet
Kellemes használatot! 🎉
Az alkalmazás teljes offline működik. Az összes adat a te gépedet marad. Nincs cloud upload, nincs nyomkövetés. Csak te és a fotóid.