Deploy PACS-AI and bring your own models

Everything a hospital IT team, a security reviewer or a model developer needs to install the platform on-premises, operate it, and register an inference model.

HeartWise-AI/pacs-ai-backend GitHub HeartWise-AI/PACS-AI GitHub Releases Report an issue Ask DeepWiki

Last reviewed against the repositories on 2026-09-22. Technical content is maintained in English.

Get started

Repositories, licences and releases Where the code lives, what is open, and how versions are cut. Architecture Five logical planes on one Docker network, with a 24-hour DICOM cache and no long-term imaging storage. Requirements Host sizing, storage, network egress and what the hospital PACS must allow.

Deploy

Install a production instance Single-host Docker Compose on a customer Linux VM. Kubernetes is out of scope. Local development Run the backend with emulated DICOM services and the viewer with yarn. Configuration reference Every environment variable that matters, grouped by concern, plus the compose overrides for common topologies.

Operate

Admin access, tenants and users How the first owner is created, what each role can do, and how registration, invites and policies work. PACS integration AE titles, DIMSE services, polling load and how modalities are registered. Automated inference pipeline Ingestion jobs, the candidate state machine, processing runs, the live worklist and result output modes. Operations Health checks, logs, metrics, upgrades, runbooks, retention, backups and recovery objectives. Security and compliance Trust boundaries, safeguards, secret rotation, PHI handling, the compliance posture and the public-demo privacy gate.

Models

Build, register and deploy models The container contract, the five files you author, the padding-mask rule, the deploy script and the admin API. Port a model with an AI agent A ready-to-paste brief for Claude Code, Codex or Cursor that turns a trained model into a PACS-AI container under human review.

Reference

Support and glossary Channels, hours, what to attach, and the DICOM terms used above.

DeepWiki

An AI-generated wiki of the backend repository, grounded in the source and organised by module. Each page here links to the matching DeepWiki pages, and you can ask it questions about the code directly. deepwiki.com/HeartWise-AI/pacs-ai-backend

Status Terms and Conditions Privacy Policy Privacy Impact Assessment Document (EFVP)

Documentation