๐Ÿฅ v0.82.1 โ€” Open-Source Clinical Documentation

Your Conversations.
Your Notes. Your Machine.

FerriScribe listens to your doctor-patient conversations and generates structured SOAP notes using a local AI model of your choice. Draft letters from scanned paper documents, interrogate charts with document chat, OCR supporting files, record from your iPhone or Android phone, and sync across devices over your network or Tailscale. No cloud AI APIs required. No subscriptions.

Why FerriScribe?
๐ŸŽฏ

Clinically Accurate

System prompt systematically optimized and benchmarked across 21 real clinical cases. Achieves 90%+ schema compliance; fields default to "Not discussed" unless explicitly stated in the transcript. Review generated notes before use.

๐Ÿ”’

Local AI & Private Storage

Local AI needs no cloud AI APIs. SQLCipher-encrypted database (AES-256) and AES-256-GCM encrypted audio at rest. Optional sharing over your network or Tailscale.

โšก

Minutes, Not Hours

Records the consultation, transcribes speech to text, and generates a structured SOAP note โ€” ready for your review before the next patient sits down.

๐Ÿ› ๏ธ

Adapts to Your Practice

Context templates for visit types, custom vocabulary find/replace rules, 6 letter audiences (Patient, Insurance, Tax Authority, Specialist, Employer, Legal) plus custom audiences. Generate referrals, clinical letters, synopses, and peer discussions with per-document custom prompts.

โœ๏ธ

Letter Writer

Draft letters straight from paper documents: drop in a scanned PDF, photo, or export โ€” or paste text โ€” and FerriScribe OCRs it and generates a letter with your recipient, type, tone, and RE line. Missing source details can be flagged with a [NOT IN SOURCE: โ€ฆ] placeholder. Review every draft before use.

๐Ÿ“„

Scanned-PDF OCR

OCR scanned and image-only PDFs page-by-page via a bundled pdfium renderer (Chrome's PDF engine) โ€” up to 50 pages at 150 DPI, auto-downloaded on first use, running entirely locally. Multi-format too: PDF, DOCX, XLSX, and images through your local vision model.

๐ŸŒ

Fully Open Source

Audit every line of code. Fork it, contribute, or customize it for your clinic. No black boxes, no vendor lock-in, no future price hikes.

๐Ÿ–ฅ๏ธ

Cross-Platform

macOS, Linux, and Windows. Runs on any capable machine with 16GB+ RAM โ€” from a MacBook Air to a clinic workstation.

๐Ÿ’ฐ

Zero Recurring Costs

No per-seat licenses. No API fees. No cloud subscriptions. Download it, run it, own it. One less line item on your practice budget.

๐Ÿ”—

Multi-Device Sync

Bidirectional content sync over LAN or Tailscale. Transcripts, SOAP notes, letters, referrals, and audio stay consistent across machines. Background sync every 5 minutes with real-time SSE updates.

๐Ÿ’พ

Runs on Consumer Hardware

Proven on Apple Silicon Mac Studio with 96GB unified memory. Runs quantized models (Qwen 3.6 35B A3B) via Ollama, LM Studio, or oMLX (MLX inference for Apple Silicon). Remote STT option lets you offload Whisper to an office server โ€” no GPU server, no special equipment needed.

๐Ÿ“‹

ICD-9 Billing Codes

7,122 bundled BC MSP ICD-9 diagnostic codes with intelligent candidate selection. Keyword-overlap inverted index enriched with medical synonyms, plus specificity adjustment favoring precise codes. Off-list codes flagged with amber chips.

๐Ÿ‘€

Inline Preview

Generated documents display in a collapsible preview directly in the Generate tab โ€” no need to switch tabs. Review SOAP notes, referrals, and letters in context.

๐ŸŒ

Remote STT (Optional)

Offload Whisper transcription to any OpenAI-compatible Whisper server on your LAN or Tailscale. Heavy model runs on your office server; laptops stay light.

๐Ÿ“„

FHIR & Multi-Format Export

Export SOAP notes as PDF, DOCX, or FHIR R4 โ€” the healthcare interoperability standard. Share structured clinical documents with any EHR system. Audio recordings exportable as standard WAV files.

โŒจ๏ธ

Keyboard-First Workflow

Space to record/stop, Cmd/Ctrl+Enter to generate SOAP notes. RSVP speed reader for rapid document review at configurable WPM with per-section filters. Drag-and-drop condition chip reordering.

๐Ÿ”

Security & Audit

SQLCipher AES-256 encrypted database with OS keychain integration. AES-256-GCM encrypted audio at rest. PBKDF2-HMAC-SHA256 key derivation. PHI-redacted log export for safe support. Soft-delete with undo toast.

๐Ÿ”„

Condition Chip Sync

Persistent condition tracking with drag-and-drop reorder. Real-time sync across paired devices via SSE. Tombstone-based conflict resolution ensures consistency across your practice.

๐Ÿ—„๏ธ

Off-Machine Backup

Encrypted, append-only snapshots pushed to a second machine on your network (or over Tailscale). Key escrow with a printable recovery sheet + offline USB, and every backup is drill-tested so you know the restore will work โ€” a dead disk can't erase your practice.

๐Ÿ’ฌ

Medical AI Chat & Chart Review

Ask a local model anything โ€” with a grounding prompt that forbids fabricated facts and carries a "review by a licensed provider" guardrail. Drop in PDFs, DOCX, XLSX, or images, or a multi-hundred-page chart: it's indexed once and every answer is retrieved from the relevant excerpts (hybrid vector + BM25), citing its source. Conversations live in memory only โ€” nothing is saved, synced, or logged.

๐Ÿง 

Thinking Control

Reasoning models (Qwen3 & co.) can spend minutes "thinking" before writing a note. A per-provider Disable thinking toggle skips the reasoning phase so SOAP notes generate fast โ€” or leave it on when you want deeper deliberation.

๐Ÿ—“๏ธ

Recordings Calendar โ€” Since v0.82.1

Pick a local date to see that day's active recordings, across your full history rather than just the loaded page. Only populated dates are offered; month and year controls skip empty months. Search narrows the selected day's results.

๐Ÿ—‘๏ธ

Trash & Recovery โ€” Since v0.81.0

Move recordings to Trash, then Undo or restore them. Choose a 7, 14, 21, or 30-day recovery window (30 by default). After that, cleanup permanently deletes audio, transcripts, SOAP notes, and generated documents.

Recording Indicator โ€” Since v0.80.0

The desktop menu-bar or system-tray icon is a green filled disc when idle and a red hollow ring while recording, distinct by shape as well as colour. Its menu lets you show or quit FerriScribe.

Four Steps to Done
1

Record

Hit record before the consultation. FerriScribe captures audio and transcribes it locally with Whisper speech-to-text.

2

Add Context

Enter medications, allergies, conditions. Drop supporting documents (PDFs, images, Word, Excel) for OCR extraction โ€” content threads into all generation types.

3

Generate

The local AI model produces a structured SOAP note with ICD-9 codes, differential diagnoses, and plans โ€” guided by context templates and your custom vocabulary.

4

Document

Preview inline, edit, or review with the RSVP speed reader. Export as PDF, DOCX, or FHIR. Copy into your EMR โ€” done before your next patient.

๐Ÿ›ก๏ธ

Local AI, With Optional Network Sharing

FerriScribe can run AI locally without cloud AI APIs. Optional phone recording and device sync share data over your network or Tailscale. Review your own configuration and safeguards before using it with patient information. The code is open source and auditable.

โœ“ Tested in Production

Battle-Tested in a Live Clinic

FerriScribe isn't a prototype โ€” it's running daily in a real family practice, generating SOAP notes from actual patient encounters. Here's the reference deployment:

๐Ÿ–ฅ๏ธ Hardware

  • Apple Mac Studio (M3 Ultra)
  • 96GB unified memory
  • All processing on a single silent desktop
  • No external GPU or server hardware

๐Ÿง  AI & Speech Models

  • LM Studio โ€” local model serving (localhost:1234) ยท Ollama & oMLX also supported
  • Qwen 3.6 35B A3B (quantized, MLX-accelerated)
  • Whisper โ€” local speech-to-text
  • Vision model (glm-ocr) โ€” document OCR ยท pdfium โ€” scanned-PDF rendering
  • Tauri v2 โ€” native desktop framework

๐ŸŒ Networking & Sync

  • Tailscale โ€” secure mesh VPN between devices
  • Bidirectional content sync (transcripts, notes, audio)
  • Background sync every 5 minutes
  • Real-time SSE updates for instant refresh
  • Office server mode with auto-resume
  • Zero exposed ports to the public internet
Backup & Recovery

A dying disk used to mean losing everything โ€” your notes, encrypted recordings, and the keys to open them all lived on one machine. Since v0.53.0, FerriScribe ships an encrypted, append-only off-machine backup tool, so a single hardware failure can never erase your practice.

๐Ÿ›ก๏ธ

How to Back Up

One-time setup โ€” then it runs itself
1

Escrow your recovery key. In the app, open Settings โ†’ Backup โ†’ Recovery key escrow. FerriScribe generates a recovery sheet and a USB file โ€” either one alone can restore everything. Print the sheet โ†’ safe. Copy the .escrow file โ†’ offline USB. Verify both.

2

Set up a backup target. A second machine on your network (a home server, or another Mac over Tailscale). It runs the append-only agent and holds the admin token that never leaves that box:

backup target โ€” run once on the server
export FERRISCRIBE_BACKUP_APPEND_TOKEN=<random>
export FERRISCRIBE_BACKUP_ADMIN_TOKEN=<different random>
ferriscribe-backup serve --root /srv/ferriscribe-backups --bind 100.64.0.2:8741
3

Point FerriScribe at it. Enter the backup target URL (http://<host>:8741) plus the append token, then enable the daily schedule (03:30) โ€” or just hit Back up now. The schedule runs outside the app (launchd), so backups continue even when FerriScribe is closed or crashed.

๐Ÿ’ก Every backup is drill-tested. The snapshot is re-pulled from the target, the database is opened with the recovered key, a sample recording is decrypted, and record counts are diffed. Settings โ†’ Backup shows the verdict and turns red on any failure. The append token can only add snapshots โ€” a compromised machine can't delete its own history.
๐Ÿ”„

How to Recover

From a single file to a full rebuild
1

Deleted one recording? Check the in-app Trash first. You can restore it during your chosen 7, 14, 21, or 30-day recovery window (30 by default) โ€” that's the fast path, not a full backup restore.

2

Pull the snapshot. Install FerriScribe fresh from the DMG (this also gives you the tool), then pull the newest snapshot โ€” verified (HMAC + per-file hashes) against your recovery sheet before anything is written:

pull the newest snapshot
ferriscribe-backup pull --url http://100.64.0.2:8741 --token <append> \
  --out ~/restored --escrow-file ~/Desktop/ferriscribe-backup-recovery-sheet.txt
3

Restore into the app. This also installs the snapshot's database key into your keychain:

restore into the data directory
ferriscribe-backup restore \
  --snapshot-dir ~/restored/<snap-id> \
  --dest ~/"Library/Application Support/rust-medical-assistant" \
  --escrow-file ~/Desktop/ferriscribe-backup-recovery-sheet.txt
4

Prove it before trusting it โ€” run a drill (re-pull, open the DB, decrypt a sample, diff counts). It prints DRILL PASSED or fails loudly. Then launch FerriScribe โ€” everything's back.

โฑ๏ธ Worst case is ~24h of data. The default daily schedule bounds data loss to the snapshot interval. restore refuses to overwrite a different existing database key unless you pass --force, so restoring an old snapshot onto a working machine can't lock you out of your current data.
Runs on What You Have
๐ŸŽ

macOS

Native Apple Silicon support with MLX optimization. Runs great on MacBook Air, MacBook Pro, and Mac Studio with M-series chips.

๐Ÿง

Linux

Full NVIDIA CUDA and AMD ROCm support. Run it on your workstation, a home server, or a dedicated clinic machine.

๐ŸชŸ

Windows

DirectML and CUDA support. Works on any capable Windows laptop or desktop with sufficient RAM for local inference.

The only requirement: a computer with enough RAM to run local models (16GB+ recommended).

Now On iOS & Android

FerriScribe Mobile โ€” a native companion that records the visit on your phone and hands it to your own server over Tailscale. Local AI on your computer, without cloud AI APIs required.

๐Ÿ“ฑ

iOS & Android

One Flutter client for both platforms. iOS via TestFlight; Android as a signed APK released on GitHub.

๐Ÿ”’

Recordings Stay on Your Server

Audio streams to your server over Tailscale and is encrypted at rest there (AES-256-GCM). The phone keeps no recording; an encrypted offline cache supports document review.

๐Ÿ“

Review & Export Anywhere

Read, edit, and export all five document types as PDF/DOCX from your pocket โ€” gated by biometrics with an encrypted offline cache.

Open source ยท github.com/cortexuvula/ferriscribe-mobile

Tech Stack
Qwen 3.6 35B
A3B quantized model
Ollama ยท LM Studio ยท oMLX
Local AI providers
Whisper
Speech-to-text
Tauri v2
Desktop framework
Flutter ยท Dart
iOS/Android client
Rust
Core engine (13 crates)
Tailscale
Secure mesh VPN + sync
BERTScore
0.837 semantic accuracy
90%+ Schema
SOAP compliance rate
SQLCipher
Encrypted database