Local-first AI assistant for audio meetings on Linux. PipeWire → STT → diarization → RAG → LLM. CLI + Tauri desktop with push-to-capture Knowledge Copilot: your documents, your answers, in real time.
Current release: 1.0.0-beta.1 (Changelog)
- CLI: Record, transcribe, analyze meetings; RAG index; cost reports; export; daemon; local Web UI.
- Desktop (Tauri): Tray app, push-to-capture hotkey, overlay with RAG-first cards (Evidence, Answer, Do/Don't, Clarify). No always-on recording; audio stays on your machine.
- Knowledge Copilot: Hold hotkey → capture a question → release → get instant cards from your documents (RAG) + optional LLM. Hybrid (local STT/RAG + cloud LLM) or offline.
- Linux with PipeWire
- Python 3.12+
- uv for install
- API keys in system keyring (optional for cloud LLM):
anthropic,openai,huggingface— see keyring reference
git clone https://github.com/iurii-izman/voiceforge.git && cd voiceforge
./scripts/bootstrap.sh
uv sync --extra all
uv run voiceforge statusDaemon + desktop (e.g. in toolbox on Fedora Atomic):
# Terminal 1
uv run voiceforge daemon
# Terminal 2
cd desktop && npm install && npm run tauri devCLI-only flow:
uv run voiceforge listen
# In another terminal:
uv run voiceforge analyze --seconds 30
uv run voiceforge historyFull install and rebuild guide: docs/runbooks/rebuild-run-test-guide.md (toolbox paths), docs/runbooks/installation-guide.md.
- Index (what to read): docs/DOCS-INDEX.md
- First run (5 min): docs/first-meeting-5min.md
- Quickstart: docs/runbooks/quickstart.md
- Config & keyring: docs/runbooks/config-env-contract.md, docs/runbooks/keyring-keys-reference.md
- Desktop build (toolbox): docs/runbooks/desktop-build-deps.md
- Releases & quality: docs/runbooks/release-and-quality.md
uv run ruff check src tests scripts
uv run pytest tests/ -q --tb=line
./scripts/verify_pr.sh
./scripts/doctor.sh- Contributing: CONTRIBUTING.md
- Security: SECURITY.md
- PR template: .github/pull_request_template.md
MIT. See LICENSE.