selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

OpenScribe logo

Self-host OpenScribe

v0.1.1

Open-source AI medical scribe for clinical documentation

BetaOpen SourceMIT
Updated5 months ago
LanguageTypescript
Setup difficultyModerate
Stars
223
RAM
8GB
Storage
20GB free disk
Ports
3001 (web application), 8002 (local Whisper transcription service)
Requires
Whisper (local transcription)
Install with Docker Compose
OpenScribe screenshot 1

What is OpenScribe?

OpenScribe is a free, MIT-licensed AI medical scribe built for clinicians. It records patient visits, transcribes the audio, and produces structured draft clinical notes. Three runtime modes are available: a default mixed web mode that keeps transcription local via Whisper while sending text to Anthropic Claude for note creation; a fully local desktop mode (Electron) that runs Whisper and Ollama models entirely on-device with no cloud calls; and a cloud fallback that uses OpenAI Whisper API plus hosted LLMs. The web front end is a Next.js application that keeps encounter data in the browser using AES-GCM encrypted localStorage; audio is handled in memory and never written to disk. The desktop installer includes a first-run wizard that downloads the required models. Note templates cover Default (History and Physical), SOAP, and a custom markdown option. The project is not yet HIPAA compliant but ships foundational privacy controls. You can deploy it via Docker Compose (SAM), grab packaged installers for macOS, Windows, or Linux, or run the pnpm development stack.

Should you self-host OpenScribe?

OpenScribe scores 44/100 on selfhost.directory (how scoring works) and ranks #4 of 5 in Healthcare. It has 223 GitHub stars.

It shipped 2 stable releases in the past year. The latest, v0.1.1, came out on 12 March 2026. New versions land roughly every 2 months.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is OpenEMR (72/100, 5 555 stars). It scores higher overall, so compare the two before you pick. See OpenScribe vs OpenEMR side by side.

Features

  • AI Medical Scribe
  • Clinical Note Generation
  • Desktop application
  • Docker Compose Deployment
  • Encrypted Local Storage
  • Local Audio Transcription
  • MedGemma Local ScribeText-only, no audio ingestion
  • Multilingual Transcription
  • Multiple Runtime Modes
  • Note templates
  • OpenClaw IntegrationDesktop app path only

OpenScribe README

How to install OpenScribe

Install OpenScribe with Docker Compose

Docker, Docker Compose
Environment variables
ANTHROPIC_API_KEY, TRANSCRIPTION_PROVIDER, WHISPER_LOCAL_URL, WHISPER_LOCAL_MODEL, etc.
pnpm run setup

Edit apps/web/.env.local and set:

ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
2. Start SAM
docker compose -f docker-compose.sam.yml up --build
3. Open the app
http://localhost:3001

SAM (Simple App Mode) - runs web app and local Whisper transcription service

How to configure OpenScribe

  • ANTHROPIC_API_KEYAnthropic API key for clinical note generation

    Anthropic API key for clinical note generation

  • MEDGEMMA_API_KEYOptional API key for MedGemma server

    Optional API key for MedGemma server

  • MEDGEMMA_BASE_URLhttp://127.0.0.1:8080Base URL for MedGemma local inference server

    Base URL for MedGemma local inference server

  • MEDGEMMA_MODELmedgemma-1.5-4b-itMedGemma model name

    MedGemma model name

  • NEXT_PUBLIC_SECURE_STORAGE_KEYBase64-encoded 32-byte secret for client-side secure storage

    Base64-encoded 32-byte secret for client-side secure storage

  • OPENAI_API_KEYOpenAI API key for audio transcription when using whisper_openai provider

    OpenAI API key for audio transcription when using whisper_openai provider

  • OPENCLAW_AGENTmainTarget OpenClaw agent/session

    Target OpenClaw agent/session

  • OPENCLAW_BINopenclawOpenClaw CLI binary path

    OpenClaw CLI binary path

  • OPENCLAW_DELIVER0Enable OpenClaw response delivery

    Enable OpenClaw response delivery

    values: 0, 1

  • OPENCLAW_DEMO_WEBHOOK_TOKENOptional webhook token for OpenClaw demo handoff

    Optional webhook token for OpenClaw demo handoff

  • OPENCLAW_DEMO_WEBHOOK_URLOptional webhook URL for OpenClaw demo handoff

    Optional webhook URL for OpenClaw demo handoff

  • TRANSCRIPTION_PROVIDERwhisper_localTranscription provider: whisper_local (default), whisper_openai, or medasr

    Transcription provider: whisper_local (default), whisper_openai, or medasr

    values: whisper_local, whisper_openai, medasr

  • WHISPER_LANGUAGEautoDefault language for transcription (auto or ISO-639-1 code)

    Default language for transcription (auto or ISO-639-1 code)

    values: auto, en, es, fr, etc.

  • WHISPER_LOCAL_BACKENDcppWhisper backend implementation

    Whisper backend implementation

    values: cpp

  • WHISPER_LOCAL_GPU1Enable GPU acceleration for local Whisper

    Enable GPU acceleration for local Whisper

    values: 0, 1

  • WHISPER_LOCAL_MAX_RETRIES2Maximum retries for local Whisper requests

    Maximum retries for local Whisper requests

  • WHISPER_LOCAL_MODELtiny.enWhisper model to use locally

    Whisper model to use locally

    values: tiny.en, base, small, etc.

  • WHISPER_LOCAL_TIMEOUT_MS15000Timeout for local Whisper requests in milliseconds

    Timeout for local Whisper requests in milliseconds

  • WHISPER_LOCAL_URLhttp://127.0.0.1:8002/v1/audio/transcriptionsLocal Whisper server URL

    Local Whisper server URL

  • WHISPER_OPENAI_MODELwhisper-1OpenAI Whisper model when using whisper_openai provider

    OpenAI Whisper model when using whisper_openai provider

OpenScribe releases & version history

FAQ

Are generated notes ready for clinical use?

AI-generated notes are drafts requiring human review. The project does not currently claim HIPAA compliance.

Does my data stay on my device?

The local-only desktop workflow uses local transcription and note models. The default mixed web workflow uses local Whisper transcription and sends transcript content to a hosted model for note generation. Choose and configure your workflow before recording.

How do I try it?

Start with the setup guide on GitHub. The latest desktop release includes a macOS Apple Silicon installer; the repository also documents self-hosted web and local desktop workflows.

Is OpenScribe free?

Yes, OpenScribe is free, open-source software under the MIT license. Hosted model providers may charge for inference when you choose a cloud-backed workflow.

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…