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.
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 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.
Records the consultation, transcribes speech to text, and generates a structured SOAP note โ ready for your review before the next patient sits down.
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.
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.
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.
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.
macOS, Linux, and Windows. Runs on any capable machine with 16GB+ RAM โ from a MacBook Air to a clinic workstation.
No per-seat licenses. No API fees. No cloud subscriptions. Download it, run it, own it. One less line item on your practice budget.
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.
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.
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.
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.
Offload Whisper transcription to any OpenAI-compatible Whisper server on your LAN or Tailscale. Heavy model runs on your office server; laptops stay light.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Hit record before the consultation. FerriScribe captures audio and transcribes it locally with Whisper speech-to-text.
Enter medications, allergies, conditions. Drop supporting documents (PDFs, images, Word, Excel) for OCR extraction โ content threads into all generation types.
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.
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.
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.
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:
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.
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.
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:
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
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.
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.
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:
ferriscribe-backup pull --url http://100.64.0.2:8741 --token <append> \
--out ~/restored --escrow-file ~/Desktop/ferriscribe-backup-recovery-sheet.txt
Restore into the app. This also installs the snapshot's database key into your keychain:
ferriscribe-backup restore \
--snapshot-dir ~/restored/<snap-id> \
--dest ~/"Library/Application Support/rust-medical-assistant" \
--escrow-file ~/Desktop/ferriscribe-backup-recovery-sheet.txt
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.
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.
Native Apple Silicon support with MLX optimization. Runs great on MacBook Air, MacBook Pro, and Mac Studio with M-series chips.
Full NVIDIA CUDA and AMD ROCm support. Run it on your workstation, a home server, or a dedicated clinic machine.
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).
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.
One Flutter client for both platforms. iOS via TestFlight; Android as a signed APK released on GitHub.
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.
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