Desktop app for learning languages by reading real texts: local LLM translate and simplify, personal vocabulary, markdown on disk.
Download the latest release for your platform from GitHub Releases:
| Platform | Artifact |
|---|---|
| macOS (Apple Silicon) | .dmg |
| Windows 10+ (x64) | .msi |
| Windows 10+ (ARM64) | -arm64.msi |
| Linux x86_64 | .AppImage |
Verify downloads with the checksums.txt SHA256 file attached to each release.
First run: an internet connection may be required for Hugging Face model weights (native LLM via bundled llama-server, MiniLM embeddings, spaCy when adding a language). Model weights are not included in the installer. See model bootstrap.
System requirements: see About LexiFlow in the app for RAM and disk guidance. Recommended: 16 GB RAM for the native LLM path.
- macOS: Gatekeeper may block the app because it is not notarized. Right-click → Open, or allow in System Settings → Privacy & Security.
- Windows: SmartScreen may warn on first launch because the installer is not Authenticode-signed. Choose More info → Run anyway if you trust the download and checksum.
- Linux: AppImage may need
chmod +x. Some distros requirelibfuse2for AppImage.
Requires uv and Python 3.12+.
git clone https://github.com/YannikG/lexiflow.git
cd lexiflow
uv sync
uv run python -m lexiflow_uiClose the window to quit.
First run: an internet connection may be required on first use (embedding model via sentence-transformers; native LLM via llama-server from Hugging Face unless you configure Ollama). See model bootstrap.
uv sync
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv run mypy packages/lexiflow-core
pre-commit run --all-filesPhase 15 packaging: PyInstaller bundle, platform installers, tag-triggered releases. See roadmap.
| Document | Purpose |
|---|---|
| CONTEXT.md | Project index — start here |
| common-language.md | Domain language (canonical glossary) |
| AGENTS.md | Instructions for AI agents |
| docs/architecture/overview.md | Processes, packages, data layout |
| packaging.md | Installers and release workflow |
Apache License 2.0 — see LICENSE.