# 🏛️ AI Genealogy / ИИ Генеалогия

**Local AI assistant for genealogical research**  
**Локальный ИИ-помощник для генеалогических исследований**

---

## 🇬🇧 What is this?

A fully local, open-source AI toolkit for genealogical research. It runs entirely on your computer — no cloud services, no subscriptions, no data leaks.

### Capabilities
- 🔍 **Semantic search** through your archive of digitized documents
- 📜 **OCR recognition** of old metric books, scans, and manuscripts (Russian, Polish, Belarusian)
- 🌐 **Private web search** via SearXNG meta-search engine
- 🕸️ **Website scraping** of genealogy forums and archives
- 💬 **AI chat** with context from your documents (RAG)
- 🧠 **Analysis** of surnames, dates, places, family connections

### Tech Stack
| Component | Purpose |
|-----------|---------|
| Open WebUI | Web interface |
| Ollama + Qwen2.5/Mistral | LLM |
| Qdrant + BGE-M3 | Vector search |
| EasyOCR + Tesseract | OCR |
| SearXNG | Web search |
| Crawl4AI | Web scraping |
| FastAPI | Integration API |

### Quick Start
```bash
ai-genealogy start    # Launch
ai-genealogy stop     # Shutdown (GPU freed)

Web UI: http://localhost:3000
API Docs: http://localhost:8000/docs

----------------------------------------------------------------------------------------------

Полностью локальный, открытый AI-инструментарий для генеалогических исследований. Всё работает на вашем компьютере — без облаков, подписок и утечек данных.
Возможности

    🔍 Семантический поиск по вашему архиву оцифрованных документов

    📜 Распознавание (OCR) старых метрических книг, сканов, рукописей (русский, польский, белорусский)

    🌐 Приватный веб-поиск через мета-поисковик SearXNG

    🕸️ Скрапинг сайтов — генеалогических форумов и архивов

    💬 AI-чат с контекстом из ваших документов (RAG)

    🧠 Анализ фамилий, дат, мест, родственных связей

Технологический стек
Компонент	Назначение
Open WebUI	Веб-интерфейс
Ollama + Qwen2.5/Mistral	Языковая модель (LLM)
Qdrant + BGE-M3	Векторный поиск
EasyOCR + Tesseract	Распознавание текста
SearXNG	Веб-поиск
Crawl4AI	Скрапинг сайтов
FastAPI	API-интеграция
Быстрый старт
bash

ai-genealogy start    # Запуск
ai-genealogy stop     # Выключение (GPU освобождается)

Веб-интерфейс: http://localhost:3000
API документация: http://localhost:8000/docs

----------------------------------------------------------------------------------------------

🔓 License / Лицензия

All components are open-source (MIT, Apache 2.0, AGPLv3).
Все компоненты с открытым исходным кодом (MIT, Apache 2.0, AGPLv3).