lore-ai 0.1.2__tar.gz

lore_ai-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lore Contributors
+
+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.

lore_ai-0.1.2/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: lore-ai
+Version: 0.1.2
+Summary: Privacy-first, local-only oral history transcription.
+Author: Digital Heritage Lab
+License: MIT
+Project-URL: Homepage, https://github.com/mabo-du/lore
+Project-URL: Documentation, https://github.com/mabo-du/lore/blob/main/USER_GUIDE.md
+Project-URL: Repository, https://github.com/mabo-du/lore.git
+Project-URL: Issue Tracker, https://github.com/mabo-du/lore/issues
+Keywords: oral-history,transcription,whisper,archival,offline
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: faster-whisper
+Requires-Dist: PyQt6
+Requires-Dist: imageio-ffmpeg
+Requires-Dist: platformdirs
+Requires-Dist: lxml
+Requires-Dist: numpy
+Requires-Dist: tsdownsample
+Requires-Dist: pyannote-audio==3.3.2
+Requires-Dist: resemblyzer>=0.1.4
+Requires-Dist: gliner2-onnx>=0.1.1
+Requires-Dist: llama-cpp-python>=0.3.25
+Requires-Dist: sqlite-vec>=0.1.9
+Requires-Dist: fastembed>=0.8.0
+Requires-Dist: cryptography>=42.0
+Provides-Extra: diarization
+Requires-Dist: pyannote-audio; extra == "diarization"
+Requires-Dist: Resemblyzer; extra == "diarization"
+Dynamic: license-file
+
+<div align="center">
+  <img src="https://img.shields.io/badge/Local_First-100%25-brightgreen.svg?style=for-the-badge" alt="Local First">
+  <img src="https://img.shields.io/badge/Python-3.12+-blue.svg?style=for-the-badge&logo=python" alt="Python 3.12+">
+  <img src="https://img.shields.io/badge/PyQt6-UI-blueviolet.svg?style=for-the-badge" alt="PyQt6">
+  <img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="MIT License">
+  <img src="https://img.shields.io/github/actions/workflow/status/mabo-du/lore/ci.yml?branch=main&style=for-the-badge" alt="CI">
+  <img src="https://img.shields.io/pypi/v/lore-ai.svg?style=for-the-badge" alt="PyPI">
+
+  <h1>Lore 🎙️</h1>
+
+  <p><strong>Privacy-First, Local-Only Oral History Transcription & Archiving</strong></p>
+</div>
+
+---
+
+**Lore** is a desktop application designed for historians, archivists, and researchers. It provides state-of-the-art AI transcription, speaker diarization, named entity recognition, and translation—**100% offline, on your own hardware.**
+
+No data leaves your computer. No cloud subscriptions. Just powerful, open-source AI packaged into a clean, intuitive PyQt6 interface.
+
+<img src="https://raw.githubusercontent.com/mabo-du/lore/main/docs/images/lore_main.png" alt="Lore Main Window" width="800">
+
+## ✨ Features
+
+- 🎧 **Offline Transcription:** Powered by `faster-whisper`, optimized for CPU inference with low memory overhead (< 8GB RAM).
+- 🗣️ **Speaker Diarization:** Automatically identifies and labels different speakers using `pyannote.audio`.
+- 🔍 **Word-Level Confidence:** Low-confidence words are visually highlighted so you can quickly spot potential hallucinations.
+- 🌍 **Local Translation:** Translate transcripts to over 200 languages completely offline using Meta's `NLLB-200` model.
+- 📖 **Custom Vocabulary:** Provide local jargon, proper nouns, and historical terms to guide Whisper's decoding graph for maximum accuracy.
+- 🏷️ **Named Entity Recognition:** Uses `GLiNER` to automatically extract people, organizations, dates, and locations.
+- 📦 **Archival Exporting:** Export your work to the **OHMS XML** format or create an **RFC 8493 BagIt** archival package with SHA-256 checksum verification.
+- 🔎 **Global Archive Search:** A unified SQLite database (`FTS5` + `sqlite-vec`) lets you instantly search across all your past projects using keyword or semantic/conceptual search.
+
+## 🚀 Installation
+
+### Option 1: Pre-built Installers (Recommended)
+
+Download the installer for your platform from the [latest release](https://github.com/mabo-du/lore/releases/latest):
+
+| Platform | Installer |
+|----------|-----------|
+| 🪟 **Windows** | `lore-windows-x86_64.zip` — Extract and run `lore.exe` |
+| 🍎 **macOS** | `lore-macos-arm64.tar.gz` — Extract and run `lore` |
+| 🐧 **Linux** | `lore-linux-x86_64.tar.gz` — Extract and run `lore` |
+
+### Option 2: Install from PyPI
+
+```bash
+pip install lore-ai
+lore
+```
+
+### Option 3: Install from Source
+
+Lore requires **Python 3.12+** and is cross-platform (Windows, macOS, Linux).
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/mabo-du/lore.git
+   cd lore
+   ```
+
+2. **Set up a virtual environment:**
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   ```
+
+3. **Install the application:**
+   ```bash
+   pip install -e .
+   ```
+
+## 🎮 Usage
+
+Start the Lore application:
+
+```bash
+lore
+```
+
+Or launch from your system's application menu if installed via the pre-built installer.
+
+1. **Select an Audio File:** Click "Browse" to select any standard audio format (WAV, MP3, M4A, OGG, FLAC).
+2. **Configure Settings:** Click the ⚙️ Settings icon to set your Custom Vocabulary and speaker diarization preferences.
+
+   <img src="https://raw.githubusercontent.com/mabo-du/lore/main/docs/images/lore_settings.png" alt="Lore Settings" width="400">
+
+3. **Transcribe & Diarize:** Click "Transcribe" on the toolbar. If recording has multiple speakers, check the "Enable Speaker Diarization" box.
+4. **Edit & Review:** Play the audio, click on segments to edit them, and review any low-confidence words highlighted in red.
+5. **Translate:** Select a target language from the dropdown and click "Translate" for fully offline translation.
+6. **Export:** Fill out the Metadata panel and export to **OHMS XML** or an Archival **BagIt Package**.
+
+For detailed instructions, see the [User Guide](USER_GUIDE.md).
+
+## 🏗️ Architecture
+
+Lore is designed with strict sequential memory management to run on older hardware.
+- Models are loaded into memory one at a time (e.g., Whisper loads, transcribes, unloads → NLLB loads, translates, unloads).
+- Heavy use of CTranslate2 (INT8 quantization) ensures models run blazingly fast without needing a dedicated GPU.
+- The UI runs asynchronously using PyQt6's `QThread` and Signals, keeping the interface completely responsive during heavy AI workloads.
+
+## 🤝 Contributing
+
+Lore is an open-source project. We welcome pull requests, bug reports, and feature requests. Please see our [User Guide](USER_GUIDE.md) for more detailed workflows and documentation on the codebase.
+
+## 📜 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

lore_ai-0.1.2/README.md

@@ -0,0 +1,108 @@
+<div align="center">
+  <img src="https://img.shields.io/badge/Local_First-100%25-brightgreen.svg?style=for-the-badge" alt="Local First">
+  <img src="https://img.shields.io/badge/Python-3.12+-blue.svg?style=for-the-badge&logo=python" alt="Python 3.12+">
+  <img src="https://img.shields.io/badge/PyQt6-UI-blueviolet.svg?style=for-the-badge" alt="PyQt6">
+  <img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="MIT License">
+  <img src="https://img.shields.io/github/actions/workflow/status/mabo-du/lore/ci.yml?branch=main&style=for-the-badge" alt="CI">
+  <img src="https://img.shields.io/pypi/v/lore-ai.svg?style=for-the-badge" alt="PyPI">
+
+  <h1>Lore 🎙️</h1>
+
+  <p><strong>Privacy-First, Local-Only Oral History Transcription & Archiving</strong></p>
+</div>
+
+---
+
+**Lore** is a desktop application designed for historians, archivists, and researchers. It provides state-of-the-art AI transcription, speaker diarization, named entity recognition, and translation—**100% offline, on your own hardware.**
+
+No data leaves your computer. No cloud subscriptions. Just powerful, open-source AI packaged into a clean, intuitive PyQt6 interface.
+
+<img src="https://raw.githubusercontent.com/mabo-du/lore/main/docs/images/lore_main.png" alt="Lore Main Window" width="800">
+
+## ✨ Features
+
+- 🎧 **Offline Transcription:** Powered by `faster-whisper`, optimized for CPU inference with low memory overhead (< 8GB RAM).
+- 🗣️ **Speaker Diarization:** Automatically identifies and labels different speakers using `pyannote.audio`.
+- 🔍 **Word-Level Confidence:** Low-confidence words are visually highlighted so you can quickly spot potential hallucinations.
+- 🌍 **Local Translation:** Translate transcripts to over 200 languages completely offline using Meta's `NLLB-200` model.
+- 📖 **Custom Vocabulary:** Provide local jargon, proper nouns, and historical terms to guide Whisper's decoding graph for maximum accuracy.
+- 🏷️ **Named Entity Recognition:** Uses `GLiNER` to automatically extract people, organizations, dates, and locations.
+- 📦 **Archival Exporting:** Export your work to the **OHMS XML** format or create an **RFC 8493 BagIt** archival package with SHA-256 checksum verification.
+- 🔎 **Global Archive Search:** A unified SQLite database (`FTS5` + `sqlite-vec`) lets you instantly search across all your past projects using keyword or semantic/conceptual search.
+
+## 🚀 Installation
+
+### Option 1: Pre-built Installers (Recommended)
+
+Download the installer for your platform from the [latest release](https://github.com/mabo-du/lore/releases/latest):
+
+| Platform | Installer |
+|----------|-----------|
+| 🪟 **Windows** | `lore-windows-x86_64.zip` — Extract and run `lore.exe` |
+| 🍎 **macOS** | `lore-macos-arm64.tar.gz` — Extract and run `lore` |
+| 🐧 **Linux** | `lore-linux-x86_64.tar.gz` — Extract and run `lore` |
+
+### Option 2: Install from PyPI
+
+```bash
+pip install lore-ai
+lore
+```
+
+### Option 3: Install from Source
+
+Lore requires **Python 3.12+** and is cross-platform (Windows, macOS, Linux).
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/mabo-du/lore.git
+   cd lore
+   ```
+
+2. **Set up a virtual environment:**
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   ```
+
+3. **Install the application:**
+   ```bash
+   pip install -e .
+   ```
+
+## 🎮 Usage
+
+Start the Lore application:
+
+```bash
+lore
+```
+
+Or launch from your system's application menu if installed via the pre-built installer.
+
+1. **Select an Audio File:** Click "Browse" to select any standard audio format (WAV, MP3, M4A, OGG, FLAC).
+2. **Configure Settings:** Click the ⚙️ Settings icon to set your Custom Vocabulary and speaker diarization preferences.
+
+   <img src="https://raw.githubusercontent.com/mabo-du/lore/main/docs/images/lore_settings.png" alt="Lore Settings" width="400">
+
+3. **Transcribe & Diarize:** Click "Transcribe" on the toolbar. If recording has multiple speakers, check the "Enable Speaker Diarization" box.
+4. **Edit & Review:** Play the audio, click on segments to edit them, and review any low-confidence words highlighted in red.
+5. **Translate:** Select a target language from the dropdown and click "Translate" for fully offline translation.
+6. **Export:** Fill out the Metadata panel and export to **OHMS XML** or an Archival **BagIt Package**.
+
+For detailed instructions, see the [User Guide](USER_GUIDE.md).
+
+## 🏗️ Architecture
+
+Lore is designed with strict sequential memory management to run on older hardware.
+- Models are loaded into memory one at a time (e.g., Whisper loads, transcribes, unloads → NLLB loads, translates, unloads).
+- Heavy use of CTranslate2 (INT8 quantization) ensures models run blazingly fast without needing a dedicated GPU.
+- The UI runs asynchronously using PyQt6's `QThread` and Signals, keeping the interface completely responsive during heavy AI workloads.
+
+## 🤝 Contributing
+
+Lore is an open-source project. We welcome pull requests, bug reports, and feature requests. Please see our [User Guide](USER_GUIDE.md) for more detailed workflows and documentation on the codebase.
+
+## 📜 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

lore_ai-0.1.2/pyproject.toml

@@ -0,0 +1,70 @@
+[project]
+name = "lore-ai"
+version = "0.1.2"
+description = "Privacy-first, local-only oral history transcription."
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+authors = [
+    { name = "Digital Heritage Lab" }
+]
+keywords = ["oral-history", "transcription", "whisper", "archival", "offline"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Education",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "faster-whisper",
+    "PyQt6",
+    "imageio-ffmpeg",
+    "platformdirs",
+    "lxml",
+    "numpy",
+    "tsdownsample",
+    "pyannote-audio==3.3.2",
+    "resemblyzer>=0.1.4",
+    "gliner2-onnx>=0.1.1",
+    "llama-cpp-python>=0.3.25",
+    "sqlite-vec>=0.1.9",
+    "fastembed>=0.8.0",
+    "cryptography>=42.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/mabo-du/lore"
+Documentation = "https://github.com/mabo-du/lore/blob/main/USER_GUIDE.md"
+Repository = "https://github.com/mabo-du/lore.git"
+"Issue Tracker" = "https://github.com/mabo-du/lore/issues"
+
+[project.optional-dependencies]
+diarization = [
+    "pyannote-audio",
+    "Resemblyzer",
+]
+
+[project.scripts]
+lore = "src.main:main"
+
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"
+
+[dependency-groups]
+dev = [
+    "pyinstaller>=6.20.0",
+]

lore_ai-0.1.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lore_ai-0.1.2/src/audio/normalise.py

@@ -0,0 +1,45 @@
+import subprocess
+from pathlib import Path
+import imageio_ffmpeg
+
+
+class AudioNormaliseError(Exception):
+    """Raised when audio normalization fails."""
+
+    pass
+
+
+def normalise(input_path: Path, output_path: Path) -> None:
+    """
+    Normalise audio to 16kHz mono PCM with EBU R128 loudness normalisation.
+    This is required for optimal faster-whisper transcription of archival audio.
+    """
+    ffmpeg_exe = imageio_ffmpeg.get_ffmpeg_exe()
+
+    cmd = [
+        ffmpeg_exe,
+        "-y",  # Overwrite output files
+        "-i",
+        str(input_path),
+        "-af",
+        "loudnorm",  # EBU R128 loudness normalization
+        "-ar",
+        "16000",  # 16 kHz sample rate
+        "-ac",
+        "1",  # Mono (1 channel)
+        "-acodec",
+        "pcm_s16le",  # 16-bit PCM
+        str(output_path),
+    ]
+
+    try:
+        # Run ffmpeg subprocess, capturing output for error reporting
+        subprocess.run(
+            cmd, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True
+        )
+    except subprocess.CalledProcessError as e:
+        raise AudioNormaliseError(
+            f"FFmpeg failed with exit code {e.returncode}:\n{e.stderr}"
+        )
+    except Exception as e:
+        raise AudioNormaliseError(f"Failed to execute FFmpeg: {str(e)}")

lore_ai-0.1.2/src/audio/player.py

@@ -0,0 +1,49 @@
+from PyQt6.QtCore import QObject, pyqtSignal, QUrl
+from PyQt6.QtMultimedia import QMediaPlayer, QAudioOutput
+
+
+class AudioPlayer(QObject):
+    """
+    AudioPlayer wraps QMediaPlayer to provide precise playback control
+    and frequent position updates for UI syncing.
+    """
+
+    position_changed = pyqtSignal(int)
+    duration_changed = pyqtSignal(int)
+    state_changed = pyqtSignal(QMediaPlayer.PlaybackState)
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self._player = QMediaPlayer(self)
+        self._audio_output = QAudioOutput(self)
+        self._player.setAudioOutput(self._audio_output)
+
+        # Fire position_changed every 50ms for tight waveform/transcript sync
+        self._player.positionChanged.connect(self.position_changed.emit)
+        self._player.durationChanged.connect(self.duration_changed.emit)
+        self._player.playbackStateChanged.connect(self.state_changed.emit)
+
+        # In PyQt6, notify interval can be set via QTimer, but QMediaPlayer handles it intrinsically or via positionChanged
+        # Actually QMediaPlayer in Qt6 emits positionChanged rapidly during playback.
+
+    def load(self, file_path: str):
+        self._player.setSource(QUrl.fromLocalFile(file_path))
+
+    def play(self):
+        self._player.play()
+
+    def pause(self):
+        self._player.pause()
+
+    def seek(self, ms: int):
+        self._player.setPosition(ms)
+
+    def position_ms(self) -> int:
+        return self._player.position()
+
+    def duration_ms(self) -> int:
+        return self._player.duration()
+
+    def set_volume(self, volume: float):
+        """Volume between 0.0 and 1.0"""
+        self._audio_output.setVolume(volume)

lore_ai-0.1.2/src/lore_ai.egg-info/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: lore-ai
+Version: 0.1.2
+Summary: Privacy-first, local-only oral history transcription.
+Author: Digital Heritage Lab
+License: MIT
+Project-URL: Homepage, https://github.com/mabo-du/lore
+Project-URL: Documentation, https://github.com/mabo-du/lore/blob/main/USER_GUIDE.md
+Project-URL: Repository, https://github.com/mabo-du/lore.git
+Project-URL: Issue Tracker, https://github.com/mabo-du/lore/issues
+Keywords: oral-history,transcription,whisper,archival,offline
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: faster-whisper
+Requires-Dist: PyQt6
+Requires-Dist: imageio-ffmpeg
+Requires-Dist: platformdirs
+Requires-Dist: lxml
+Requires-Dist: numpy
+Requires-Dist: tsdownsample
+Requires-Dist: pyannote-audio==3.3.2
+Requires-Dist: resemblyzer>=0.1.4
+Requires-Dist: gliner2-onnx>=0.1.1
+Requires-Dist: llama-cpp-python>=0.3.25
+Requires-Dist: sqlite-vec>=0.1.9
+Requires-Dist: fastembed>=0.8.0
+Requires-Dist: cryptography>=42.0
+Provides-Extra: diarization
+Requires-Dist: pyannote-audio; extra == "diarization"
+Requires-Dist: Resemblyzer; extra == "diarization"
+Dynamic: license-file
+
+<div align="center">
+  <img src="https://img.shields.io/badge/Local_First-100%25-brightgreen.svg?style=for-the-badge" alt="Local First">
+  <img src="https://img.shields.io/badge/Python-3.12+-blue.svg?style=for-the-badge&logo=python" alt="Python 3.12+">
+  <img src="https://img.shields.io/badge/PyQt6-UI-blueviolet.svg?style=for-the-badge" alt="PyQt6">
+  <img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="MIT License">
+  <img src="https://img.shields.io/github/actions/workflow/status/mabo-du/lore/ci.yml?branch=main&style=for-the-badge" alt="CI">
+  <img src="https://img.shields.io/pypi/v/lore-ai.svg?style=for-the-badge" alt="PyPI">
+
+  <h1>Lore 🎙️</h1>
+
+  <p><strong>Privacy-First, Local-Only Oral History Transcription & Archiving</strong></p>
+</div>
+
+---
+
+**Lore** is a desktop application designed for historians, archivists, and researchers. It provides state-of-the-art AI transcription, speaker diarization, named entity recognition, and translation—**100% offline, on your own hardware.**
+
+No data leaves your computer. No cloud subscriptions. Just powerful, open-source AI packaged into a clean, intuitive PyQt6 interface.
+
+<img src="https://raw.githubusercontent.com/mabo-du/lore/main/docs/images/lore_main.png" alt="Lore Main Window" width="800">
+
+## ✨ Features
+
+- 🎧 **Offline Transcription:** Powered by `faster-whisper`, optimized for CPU inference with low memory overhead (< 8GB RAM).
+- 🗣️ **Speaker Diarization:** Automatically identifies and labels different speakers using `pyannote.audio`.
+- 🔍 **Word-Level Confidence:** Low-confidence words are visually highlighted so you can quickly spot potential hallucinations.
+- 🌍 **Local Translation:** Translate transcripts to over 200 languages completely offline using Meta's `NLLB-200` model.
+- 📖 **Custom Vocabulary:** Provide local jargon, proper nouns, and historical terms to guide Whisper's decoding graph for maximum accuracy.
+- 🏷️ **Named Entity Recognition:** Uses `GLiNER` to automatically extract people, organizations, dates, and locations.
+- 📦 **Archival Exporting:** Export your work to the **OHMS XML** format or create an **RFC 8493 BagIt** archival package with SHA-256 checksum verification.
+- 🔎 **Global Archive Search:** A unified SQLite database (`FTS5` + `sqlite-vec`) lets you instantly search across all your past projects using keyword or semantic/conceptual search.
+
+## 🚀 Installation
+
+### Option 1: Pre-built Installers (Recommended)
+
+Download the installer for your platform from the [latest release](https://github.com/mabo-du/lore/releases/latest):
+
+| Platform | Installer |
+|----------|-----------|
+| 🪟 **Windows** | `lore-windows-x86_64.zip` — Extract and run `lore.exe` |
+| 🍎 **macOS** | `lore-macos-arm64.tar.gz` — Extract and run `lore` |
+| 🐧 **Linux** | `lore-linux-x86_64.tar.gz` — Extract and run `lore` |
+
+### Option 2: Install from PyPI
+
+```bash
+pip install lore-ai
+lore
+```
+
+### Option 3: Install from Source
+
+Lore requires **Python 3.12+** and is cross-platform (Windows, macOS, Linux).
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/mabo-du/lore.git
+   cd lore
+   ```
+
+2. **Set up a virtual environment:**
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   ```
+
+3. **Install the application:**
+   ```bash
+   pip install -e .
+   ```
+
+## 🎮 Usage
+
+Start the Lore application:
+
+```bash
+lore
+```
+
+Or launch from your system's application menu if installed via the pre-built installer.
+
+1. **Select an Audio File:** Click "Browse" to select any standard audio format (WAV, MP3, M4A, OGG, FLAC).
+2. **Configure Settings:** Click the ⚙️ Settings icon to set your Custom Vocabulary and speaker diarization preferences.
+
+   <img src="https://raw.githubusercontent.com/mabo-du/lore/main/docs/images/lore_settings.png" alt="Lore Settings" width="400">
+
+3. **Transcribe & Diarize:** Click "Transcribe" on the toolbar. If recording has multiple speakers, check the "Enable Speaker Diarization" box.
+4. **Edit & Review:** Play the audio, click on segments to edit them, and review any low-confidence words highlighted in red.
+5. **Translate:** Select a target language from the dropdown and click "Translate" for fully offline translation.
+6. **Export:** Fill out the Metadata panel and export to **OHMS XML** or an Archival **BagIt Package**.
+
+For detailed instructions, see the [User Guide](USER_GUIDE.md).
+
+## 🏗️ Architecture
+
+Lore is designed with strict sequential memory management to run on older hardware.
+- Models are loaded into memory one at a time (e.g., Whisper loads, transcribes, unloads → NLLB loads, translates, unloads).
+- Heavy use of CTranslate2 (INT8 quantization) ensures models run blazingly fast without needing a dedicated GPU.
+- The UI runs asynchronously using PyQt6's `QThread` and Signals, keeping the interface completely responsive during heavy AI workloads.
+
+## 🤝 Contributing
+
+Lore is an open-source project. We welcome pull requests, bug reports, and feature requests. Please see our [User Guide](USER_GUIDE.md) for more detailed workflows and documentation on the codebase.
+
+## 📜 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

lore_ai-0.1.2/src/lore_ai.egg-info/SOURCES.txt

@@ -0,0 +1,40 @@
+LICENSE
+README.md
+pyproject.toml
+src/__init__.py
+src/main.py
+src/audio/normalise.py
+src/audio/player.py
+src/lore_ai.egg-info/PKG-INFO
+src/lore_ai.egg-info/SOURCES.txt
+src/lore_ai.egg-info/dependency_links.txt
+src/lore_ai.egg-info/entry_points.txt
+src/lore_ai.egg-info/requires.txt
+src/lore_ai.egg-info/top_level.txt
+src/lore_core/__init__.py
+src/lore_core/audio_classifier.py
+src/lore_core/bagit_exporter.py
+src/lore_core/diarization.py
+src/lore_core/engine.py
+src/lore_core/global_search.py
+src/lore_core/languages.py
+src/lore_core/llm_worker.py
+src/lore_core/ner_worker.py
+src/lore_core/ohms_exporter.py
+src/lore_core/rag_worker.py
+src/lore_core/taxonomy_manager.py
+src/lore_core/translation_worker.py
+src/lore_core/exporters/__init__.py
+src/transcription/worker.py
+src/ui/file_picker.py
+src/ui/global_search_dialog.py
+src/ui/main_window.py
+src/ui/metadata_widget.py
+src/ui/settings_dialog.py
+src/ui/transcript_widget.py
+src/ui/waveform_widget.py
+src/utils/model_manager.py
+src/utils/token_vault.py
+tests/test_bagit.py
+tests/test_e2e_workflow.py
+tests/test_global_search.py

lore_ai-0.1.2/src/lore_ai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

lore_ai-0.1.2/src/lore_ai.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+lore = src.main:main

lore_ai-0.1.2/src/lore_ai.egg-info/requires.txt

@@ -0,0 +1,18 @@
+faster-whisper
+PyQt6
+imageio-ffmpeg
+platformdirs
+lxml
+numpy
+tsdownsample
+pyannote-audio==3.3.2
+resemblyzer>=0.1.4
+gliner2-onnx>=0.1.1
+llama-cpp-python>=0.3.25
+sqlite-vec>=0.1.9
+fastembed>=0.8.0
+cryptography>=42.0
+
+[diarization]
+pyannote-audio
+Resemblyzer