๐Ÿฅ v0.35 โ€” 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 that runs entirely on your computer. Document OCR, multi-device sync over Tailscale. No cloud APIs. No data transmission. No subscriptions. HIPAA-compliant by design โ€” because nothing ever leaves your device.

Why FerriScribe?
๐ŸŽฏ

Clinically Accurate

System prompt systematically optimized and benchmarked across 21 real clinical cases. Achieves 90%+ schema compliance with zero fabricated patient data โ€” every field defaults to "Not discussed" unless explicitly stated in the transcript.

๐Ÿ”’

100% Local & Private

All processing on-device. SQLCipher-encrypted database (AES-256). Audio recordings encrypted at rest with AES-256-GCM. No cloud APIs, no data transmission. HIPAA-compliant by architecture.

โšก

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.

๐ŸŒ

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 192GB unified memory. Runs quantized models (Qwen 3.6 35B A3B) via LM Studio. 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.

๐Ÿ‘๏ธ

Document OCR

Drop supporting documents (PDF, images, Word, Excel, TIFF) to extract text via a local vision model. OCR'd content automatically threads into SOAP notes, referrals, and letters alongside patient context.

๐Ÿ‘€

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.

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.

๐Ÿ›ก๏ธ

HIPAA-Compliant by Design

FerriScribe runs entirely on your local machine โ€” no cloud APIs, no data transmission, no third-party servers. Patient conversations never leave your device. This isn't a privacy policy you have to trust; it's an architecture you can verify. Every line of 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
  • M-series chip with 192GB 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)
  • Qwen 3.6 35B A3B (quantized, MLX-accelerated)
  • Whisper โ€” local speech-to-text
  • Vision model (glm-ocr) โ€” document OCR
  • 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
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).

Tech Stack
Qwen 3.6 35B
A3B quantized model
LM Studio
Local model serving
Whisper
Speech-to-text
Vision OCR
glm-ocr document extraction
Tauri v2
Desktop framework
Rust
Core engine (13 crates)
Tailscale
Secure mesh VPN + sync
BERTScore
0.837 semantic accuracy
90%+ Schema
SOAP compliance rate
SQLCipher
Encrypted database