MiniMed

MiniMed is an offline-first search and evidence assistant for medical source material. A clinician can paste a patient case, search a local SQLite corpus, open the exact source fragment, and optionally use a small local model to reorder results and extract source-linked diagnostic or dosing evidence.

The application remains useful with no network, model, account, or hosted backend.

Current boundary

Implemented:

• Russian case-query parsing, including negative findings and missing-field prompts;
• local SQLite/FTS5 and deterministic vector retrieval;
• exact document, section, chunk, anchor, and neighboring-context navigation;
• installable read-only content-module contracts;
• optional browser-local GGUF inference;
• model-assisted reranking and exact-source clinical extraction;
• deterministic rejection of invented citations and unsupported dose text;
• device-local patient cards, nested notes, follow-up reminders, and separately labelled personal matches in search.

The discovery core links to the full databases (clinical recommendations, drug instructions, ICD-10, regulatory acts, reference material); document text arrives as separately installed modules. The 15-card public pilot was retired on 2026-10-02 (docs/research/pilot-corpus-retired-2026-10-02.md).

See PRODUCT.md for the product contract, CURRENT_STATE.md for implemented status, and TECHNICAL_PLAN.md for the ordered plan.

Quick start

Requirements:

• Bun 1.2.3;
• Python 3.12+ and uv for content tooling;
• Chromium for browser tests.

Install only locked dependencies:

bun install --frozen-lockfile
uv sync --project tools/ingest --all-groups --locked

Run the web app:

bun run dev

Local servers must bind to 127.0.0.1. Run app, test, and build processes from a sanitized environment that does not inherit provider credentials, release tokens, private-corpus paths, or upload targets. Local-model downloads are optional and disabled in browser automation unless explicitly enabled.

Install a prepared icon pack with bun run icons:install path/to/minimed-icon-pack.zip, then run bun run icons:check. bun run icons:generate remains available for source-master previews.

Verification

bun run check
bun run typecheck
bun run test
bun run build
bun run python:check
bun run benchmark:all
bun run native:source:check

Benchmark the released corpus (core.db alone, as CI does; the release variant adds the companion packs):

bun run benchmark:all
bun run benchmark:real:release

The generated database and reports live under data/build/ and are intentionally ignored by Git. Never hand-edit generated SQLite or JSON packs.

Add private documents

Private inputs remain outside Git:

bun run content:prepare:private
bun run content:lint:private
bun run content:build:private

The deterministic preparer accepts declared Markdown, text-layer PDF, and OCR text inputs. It preserves checksums and page/block or line provenance before the pack builder creates SQLite.

Do not commit source documents, patient data, model weights, credentials, or generated private packs.

Repository map

apps/app/                 SolidJS browser application
apps/landing/             Static project page
packages/contracts/       Public typed contracts
packages/core/            MedicalCore orchestration and retrieval fusion
packages/search-lexical/  Russian query analysis
packages/search-semantic/ Deterministic portable vector profile
packages/storage*/        Store ports and SQLite/native adapters
content/                  Public authored and synthetic fixture sources
tools/ingest/             Deterministic content pipeline
tools/benchmarks/         Retrieval and clinical-case benchmarks
docs/                     Product, architecture, and operating contracts
branding/                 App-icon master (`app-icon-source.png`)

Dependency direction is:

UI → MedicalCore → ports → adapters

private sources → deterministic preparer → Markdown/provenance → pack builder → SQLite