run-hfs-and-hts

Starts HFS FHIR server and HTS terminology server together with terminology integration for local development.

51|19|Updated Jan 4, 2025
One-click install
npx skills add https://github.com/HeliosSoftware/hfs --skill run-hfs-and-hts-heliossoftware
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-hfs-and-hts
Source: https://github.com/HeliosSoftware/hfs/tree/main/.claude/skills/run-hfs-and-hts
Command: npx skills add https://github.com/HeliosSoftware/hfs --skill run-hfs-and-hts-heliossoftware

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working on the Helios FHIR Server often need both the HFS FHIR server and the HTS terminology server running together so that terminology-backed features like the FHIR search :in modifier and FHIRPath memberOf()/subsumes() functions work locally. This Skill provides the exact startup commands and environment variable wiring to run both servers in a coordinated local setup. ## Core Features & Use Cases - Combined Server Startup: Step-by-step bash and PowerShell commands to launch HTS (seeded from bundled terminology data) followed by HFS wired to it via HFS_TERMINOLOGY_SERVER and FHIRPATH_TERMINOLOGY_SERVER. - Terminology-Backed Features: Enables ValueSet expansion filtering via the search :in modifier, FHIRPath memberOf()/subsumes() delegation, and the crates/ui terminology-proxy handlers. - Sanity Checks: Ready-made curl commands to verify health endpoints, TerminologyCapabilities metadata, and the HTS admin UI. - Use Case: When developing HFS features that delegate terminology operations to HTS, or building UI terminology pages that proxy through HFS, use this Skill to bring up the full local stack in two terminals. ## Quick Start Ask the assistant to start the HTS terminology server seeded with the bundled terminology data and then start the HFS server pointed at it for local development.

Frequently Asked Questions about run-hfs-and-hts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run the HFS FHIR server and HTS terminology server together locally?▼

Start HTS first with HTS_BOOTSTRAP_DIR pointing to the bundled terminology data, then start HFS with HFS_TERMINOLOGY_SERVER and FHIRPATH_TERMINOLOGY_SERVER set to http://127.0.0.1:8090. HTS binds port 8090 and HFS binds port 8080.

What features require the HTS terminology server in HFS?▼

The FHIR search :in modifier for ValueSet expansion filtering, FHIRPath memberOf() and subsumes() functions, and the crates/ui terminology-proxy handlers all require HTS. Without HFS_TERMINOLOGY_SERVER set, these features degrade gracefully rather than erroring.

Does HFS need HTS running before it starts?▼

HFS reads HFS_TERMINOLOGY_SERVER at request time, not at boot, so strict startup ordering is not enforced. However, HTS should finish its bootstrap import before any terminology lookups can succeed.

How do I verify both FHIR servers are running correctly?▼

Curl the health endpoints on ports 8080 and 8090, check http://localhost:8090/metadata?mode=terminology for TerminologyCapabilities once seeded, and request /ui/hts expecting a 200 response unless HTS_UI_ENABLED is false.

Can I disable the HTS admin UI when running both servers?▼

Yes, set HTS_UI_ENABLED=false to opt out of the HTS administrative UI at /ui/hts. Both UIs are on by default: HFS's UI at port 8080/ui and HTS's admin UI at port 8090/ui/hts.