Omnilingo

AI-first desktop language learning. Pick any language pair you want, type a word, and let the model generate the bilingual definition, grammar lessons, verb conjugations and conversation practice on demand. No dictionary downloads, no offline word lists — every lookup is AI-generated.

Built with Tauri v2, React 19 and TypeScript.

• Dictionary — type any word in your source or target language; the AI returns a structured bilingual entry (translation, grammar, examples, usage notes, synonyms/antonyms) in your native language. Results are cached so you don't pay the round-trip twice.
• Grammar — AI-generated lessons on any topic, with key points, bilingual examples and three exercise types (multiple choice, fill-in-the-blank, true/false). Saved to a local SQLite database.
• Conjugation — AI-generated conjugation tables for any verb, with a typing-practice mode that checks your answers form by form.
• Conversation — scenario-based AI role-play (5 presets, 5 built-in scenarios, custom scenarios you can write yourself), with full session history.
• AI writing tools — Rephrase, Corrector, Synonyms and Text Analysis (sentence mining), each as a focused single-purpose view.
• 80+ languages — pick any source/target combination from a curated list covering >95% of the world's spoken languages. Pairs are created instantly with no download.
• Command palette — fast navigation with Cmd/Ctrl + K.
• Local-first — everything is stored in a local SQLite database. AI calls go directly from your machine to the provider you configure; there is no Omnilingo backend.
• Multi-pair — add and switch between language pairs from Settings or the sidebar.
• Text-to-speech — pronunciation playback in Dictionary via the browser Web Speech API.
• Dark mode — full dark theme with system / light / dark toggle.

Local providers (CLIs and localhost servers) need no API key.

• Rust ≥ 1.77
• Bun ≥ 1.0
• Tauri system dependencies — see docs

git clone https://github.com/maxgfr/omnilingo.git
cd omnilingo
bun install

# Run the full app in dev mode (hot reload frontend + backend)
cargo tauri dev

# Frontend only (Vite dev server)
bun run dev

# Frontend production build
bun run build

# TypeScript typecheck
bun run typecheck

# Frontend tests
bun vitest run

# Rust lint and tests
cargo clippy --manifest-path src-tauri/Cargo.toml -- -D warnings
cargo test --manifest-path src-tauri/Cargo.toml

cargo tauri build

Artifacts are produced in src-tauri/target/release/bundle/:

• macOS — .dmg, .app
• Windows — .msi, .exe

The published .dmg is not Apple-notarized, so macOS marks it with a quarantine attribute and refuses to launch it ("Omnilingo is damaged and can't be opened" or "from an unidentified developer"). After dragging Omnilingo into /Applications, clear the quarantine flag once:

xattr -cr /Applications/Omnilingo.app

Then open the app normally. You only need to run this command after a fresh install or update.

omnilingo/
├── src/                       React + TypeScript frontend
│   ├── views/                 Dictionary, Grammar, Conjugation, Conversation,
│   │                          Rephrase, Corrector, Synonyms, TextAnalysis, Settings
│   ├── components/            Layout, CommandPalette, Exercise,
│   │                          DictionaryPairSelector, tools/, ui/
│   ├── store/                 useAppStore.ts (Zustand) + AppContext.tsx (facade)
│   ├── lib/                   bridge.ts, languages.ts, ai-cache, markdown,
│   │                          useExampleTranslations, useFeaturePair, ...
│   ├── i18n/                  i18next + locales/en.json
│   └── types/                 Zod schemas + TypeScript interfaces
├── src-tauri/                 Rust backend
│   ├── src/commands/          ai, chat, conjugation, conversation,
│   │                          grammar, memory, settings
│   ├── src/db.rs              SQLite (WAL, unaccent, migrations runner)
│   └── migrations/            001_initial_schema.sql … 009_remove_freedict.sql
├── memory/                    Markdown progression files
└── .github/workflows/         build.yml, release.yml

• Frontend — React 19, TypeScript 5.8, Vite 7, Tailwind CSS v4, Zustand 5, react-router-dom 7, react-i18next, lucide-react, fuse.js, zod, vitest (jsdom)
• Backend — Rust, Tauri v2, rusqlite 0.31 (bundled, with custom functions), reqwest 0.12 (rustls-tls), tokio, chrono, tauri-plugin-log / -updater / -process. Optional mcp feature gates tauri-plugin-mcp-bridge for E2E testing.
• Package manager — bun

git tag -a v2.0.0 -m "v2.0.0"
git push origin v2.0.0

The release.yml workflow then:

1. Builds the app for macOS Apple Silicon, macOS Intel and Windows
2. Creates a GitHub Release with .dmg and .msi / .exe artifacts
3. Generates latest.json for the in-app updater

For signing and notarization:

MIT