dhti-cli 1.1.0 → 1.2.0

package/README.md

@@ -25,6 +25,8 @@ Generative AI features are built as [LangServe Apps](https://python.langchain.co
 
 🚀 You can test the elixir using a real EMR system, [OpenMRS](https://openmrs.org/), that communicates with the elixir using **CDS-Hooks** or use any other CDS-Hooks compatible EMR system. You can also use the [CDS-Hooks sandbox for testing](https://github.com/dermatologist/cds-hooks-sandbox/tree/dhti-1) without an EMR.
 
+🚀 Checkout **[Vidhi Recipes](/vidhi/README.md)** for chatbot, RAG, imaging (DICOM) and MCPX for dockerized calculators
+
 #### How (non‑technical / clinical)
 DHTI includes ready‑to‑use [skills](/.github/skills/) that can prompt agentic platforms (e.g., [AntiGravity](https://antigravity.google/), VSCode, or Claude) to generate the GenAI backends and UI components (elixirs and conches) you need. Test these components with synthetic data in OpenMRS or the CDS‑Hooks sandbox, then hand them off to production teams. Because DHTI follows open standards, that handoff (the “valley of death”) becomes smoother and more predictable. Try the [prompts](/.github/skills/start-dhti/examples/e2e-sample.md) in your preferred agentic platform after cloning this repo.
 
@@ -52,15 +54,16 @@ npx dhti-cli docker -u                    # start services from compose
 ```
 
 Notes:
-- Configure models and hyperparameters in `~/dhti/elixir/app/bootstrap.py` or install from a local directory using `-l`.
+- Install from a local directory using `-l`.
 - Stop and remove containers with `npx dhti-cli docker -d`.
 
 ✌️  Decide where to test the new elixir: OpenMRS a full EHR system, or CDS-Hooks sandbox for a lightweight testing without an EHR.
 
 💥  Test elixir in a  CDS-Hooks sandbox.
 
-* `npx dhti-cli conch start -n dhti-elixir-schat` and navigate to the Application URL displayed in the console. (Uses hapi.fhir.org).
-* In the **Rx View** tab, type in the contentString textbox and wait for the elixir to respond.
+* `npx dhti-cli elixir start -n dhti-elixir-schat` and navigate to the **Application URL displayed in the console** (scroll up to see this). Not the base URL listed at the bottom.
+* Uses hapi.fhir.org for data.
+* In the **Rx View** tab, type in the contentString textbox and wait for the elixir to respond (Submits automatically in 5 seconds).
 
 <p align="center">
   <img src="https://github.com/dermatologist/dhti/blob/develop/notes/cds-hook-sandbox.jpg" />
@@ -88,12 +91,17 @@ You will see the new **patient context aware chatbot** in the patient summary pa
 
 * `npx dhti-cli docker -d` to stop and delete all the docker containers.
 
+## Configuration
+
+* `npx dhti-cli docker bootstrap -f bootstrap.py` will create and sync bootstrap.py where you can configure default model and hyperparameters for LangServe. Run this command after changing bootstrap.py to apply the changes.
+
 ## Wiki & Documentation
 * [![Wiki](https://img.shields.io/badge/DHTI-wiki-demo)](https://github.com/dermatologist/dhti/wiki)
 * [Documentation](https://dermatologist.github.io/dhti/)
 * [CLI Reference](/notes/README.md)
 
 ## User contributions & examples
+* 🚀 **[Vidhi Recipes](/vidhi/README.md)** for chatbot, RAG, imaging (DICOM) and MCPX for dockerized calculators
 * [Elixirs](https://github.com/dermatologist/dhti-elixir)
 * [OpenMRS Conches / UI](https://github.com/dermatologist/openmrs-esm-dhti)
 * [CDS Hooks Sandbox for testing](https://github.com/dermatologist/cds-hooks-sandbox)
@@ -101,14 +109,16 @@ You will see the new **patient context aware chatbot** in the patient summary pa
 ## Presentations
 ⭐️ **Pitched at [Falling Walls Lab Illinois](https://falling-walls.com/falling-walls-lab-illinois) and released on 2025-09-12.**
 
-## What problems do DHTI solve?
+## 🔧 What problems do DHTI solve?
 
 | Why | How |
 | --- | --- |
+| I am a clinician! I have no idea how to build GenAI apps. | ✨ DHTI comes with batteries ([skills](/.github/skills/)) included! Use your preferred agentic platform (e.g., [AntiGravity](https://antigravity.google/), [VSCode with Copilot in agent mode](https://code.visualstudio.com/docs/copilot/overview), Claude, [Cursor](https://cursor.com/) and many other) to generate elixirs and conches from [problem-oriented prompts](/prompts/e2e-sample.md) (most of these platforms have a free tier). Test them using synthetic data in OpenMRS or the CDS-Hooks sandbox, then hand them off to production teams. |
 | I know LangChain, but I don’t know how to build a chain/agent based on data in our EHR. | [These sample elixirs](https://github.com/dermatologist/dhti-elixir) adopt FHIR and cds-hooks as standards for data retrieval and display. The [base class](https://github.com/dermatologist/dhti-elixir-base) provides reusable artifacts |
 | I need a simple platform for experimenting. | This repository provides  everything to start experimenting fast. The command-line tools help to virtualize and orchestrate your experiments using [Docker](https://www.docker.com/)|
 | I am a UI designer. I want to design helpful UI for real users. | See [these sample conches](https://github.com/dermatologist/openmrs-esm-dhti). It shows how to build interface components (conches) for [OpenMRS](https://openmrs.org/) an open-source EMR used by many. Read more about [OpenMRS UI](https://o3-docs.openmrs.org/) |
 | We use another EMR  |  Your EMR may support CDS-Hook for displaying components. In that case, you can use [cds-hooks-sandbox for testing](https://github.com/dermatologist/cds-hooks-sandbox/tree/dhti-1) |
+| We don't use an EMR. We use a web based health information system for ------ population with no FHIR support. | You can still use DHTI as a GenAI experimentation platform. ✨ We have a [browser extension](https://github.com/dermatologist/openmrs-esm-dhti/blob/develop/packages/dhti-screen-grabber/README.md) that can read any web page! |
 | Our IT team is often unable to take my experiments to production. | Use DHTI, follow the recommended patterns, and you will make their lives easier.|
 
 

package/dist/commands/compose.js

@@ -80,6 +80,7 @@ export default class Compose extends Command {
         const mcpx = ['mcpx'];
         const docktor = ['mcpx'];
         const medplum = ['medplum-server', 'medplum-app', 'postgres-db', 'redis', 'mpclient'];
+        const orthanc = ['orthanc', 'cors-proxy'];
         const _modules = {
             cqlFhir,
             docktor,
@@ -95,6 +96,7 @@ export default class Compose extends Command {
             openmrs,
             redis,
             webui,
+            orthanc,
         };
         try {
             const masterData = yaml.load(fs.readFileSync(path.join(RESOURCES_DIR, 'docker-compose-master.yml'), 'utf8'));

package/dist/commands/conch.d.ts

@@ -10,7 +10,7 @@ export default class Conch extends Command {
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         git: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         local: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         sources: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         workdir: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/conch.js

@@ -8,10 +8,12 @@ import { promisify } from 'node:util';
 const execAsync = promisify(exec);
 export default class Conch extends Command {
     static args = {
-        op: Args.string({ description: 'Operation to perform (init, install, or start)' }),
+        op: Args.string({ description: 'Operation to perform (add, init, install, or start)' }),
     };
     static description = 'Initialize, install, or start OpenMRS frontend development';
     static examples = [
+        '<%= config.bin %> <%= command.id %> add -g my-repo/my-package -n my-package -w ~/projects',
+        '<%= config.bin %> <%= command.id %> add -g my-repo/my-package -b main -n my-package -w ~/projects',
         '<%= config.bin %> <%= command.id %> install -n my-app -w ~/projects',
         '<%= config.bin %> <%= command.id %> init -n my-app -w ~/projects',
         '<%= config.bin %> <%= command.id %> start -n my-app -w ~/projects',
@@ -29,14 +31,14 @@ export default class Conch extends Command {
         }),
         git: Flags.string({
             char: 'g',
-            default: 'dermatologist/openmrs-esm-dhti-template',
+            default: 'dermatologist/openmrs-esm-dhti',
             description: 'GitHub repository to install (for install operation)',
         }),
         local: Flags.string({
             char: 'l',
             description: 'Local path to use instead of calculated workdir/name path (for start operation)',
         }),
-        name: Flags.string({ char: 'n', description: 'Name of the conch' }),
+        name: Flags.string({ char: 'n', default: 'esm-dhti', description: 'Name of the conch' }),
         sources: Flags.string({
             char: 's',
             description: 'Additional sources to include when starting (e.g., packages/esm-chatbot-agent, packages/esm-another-app)',
@@ -50,6 +52,43 @@ export default class Conch extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(Conch);
+        if (args.op === 'add') {
+            // Validate that git and name are overridden from defaults
+            const defaultGit = 'dermatologist/openmrs-esm-dhti';
+            const defaultName = 'esm-dhti';
+            const gitOverridden = flags.git !== defaultGit;
+            const nameOverridden = flags.name !== defaultName;
+            if (!gitOverridden || !nameOverridden) {
+                console.log(chalk.yellow('Note: The "add" operation requires non-default values for both --git and --name flags.'));
+                if (!gitOverridden) {
+                    console.log(chalk.yellow('  Current --git: (default)'));
+                }
+                if (!nameOverridden) {
+                    console.log(chalk.yellow('  Current --name: (default)'));
+                }
+                console.log(chalk.yellow('\nNo changes made. Please provide custom --git and --name values.'));
+                this.exit(0);
+            }
+            if (flags['dry-run']) {
+                console.log(chalk.yellow('[DRY RUN] Would execute add operation:'));
+                const targetPath = path.join(flags.workdir, 'esm-dhti', 'packages', flags.name);
+                console.log(chalk.cyan(`  npx degit ${flags.git}#${flags.branch} ${targetPath}`));
+                return;
+            }
+            try {
+                console.log(chalk.blue(`Adding package ${flags.name} from ${flags.git}#${flags.branch}...`));
+                const targetPath = path.join(flags.workdir, 'esm-dhti', 'packages', flags.name);
+                const degitCommand = `npx degit ${flags.git}#${flags.branch} ${targetPath}`;
+                await execAsync(degitCommand);
+                console.log(chalk.green('✓ Package added successfully'));
+                console.log(chalk.green(`\n✓ Package is ready at ${targetPath}`));
+            }
+            catch (error) {
+                console.error(chalk.red('Error during add operation:'), error);
+                this.exit(1);
+            }
+            return;
+        }
         if (args.op === 'init') {
             // Validate required flags
             if (!flags.workdir) {
@@ -214,7 +253,7 @@ export default class Conch extends Command {
             return;
         }
         // If no valid operation is provided
-        console.error(chalk.red('Error: Invalid operation. Use "install", "init", or "start"'));
+        console.error(chalk.red('Error: Invalid operation. Use "add", "install", "init", or "start"'));
         this.exit(1);
     }
 }

package/dist/commands/docker.js

@@ -110,15 +110,20 @@ export default class Docker extends Command {
                 console.log('Please provide a valid path to bootstrap.py file');
                 this.exit(1);
             }
-            const copyCommand = `docker cp ${flags.file} ${flags.container}:/app/app/bootstrap.py`;
+            // Determine copy direction based on whether local file exists
+            const fileExists = fs.existsSync(flags.file);
+            const copyCommand = fileExists
+                ? `docker cp ${flags.file} ${flags.container}:/app/app/bootstrap.py`
+                : `docker cp ${flags.container}:/app/app/bootstrap.py ${flags.file}`;
             const restartCommand = `docker restart ${flags.container}`;
             if (flags['dry-run']) {
                 console.log(chalk.yellow('[DRY RUN] Would execute:'));
-                console.log(chalk.cyan(`  ${copyCommand}`));
+                const direction = fileExists ? 'to container' : 'from container';
+                console.log(chalk.cyan(`  ${copyCommand} (copy ${direction})`));
                 console.log(chalk.cyan(`  ${restartCommand}`));
                 return;
             }
-            // copy -f to container:/app/app/ and only restart after copy completes
+            // copy file and only restart after copy completes
             exec(copyCommand, (error, stdout, stderr) => {
                 if (error) {
                     console.error(`exec error: ${error}`);

package/dist/resources/docker-compose-master.yml

@@ -1,4 +1,3 @@
-
 services:
   gateway:
     image: beapen/dhti-gateway:latest
@@ -88,7 +87,6 @@ services:
       - OPENROUTER_API_KEY=${OPENROUTER_API_KEY:-openrouter-api-key}
       - FHIR_BASE_URL=${FHIR_BASE_URL:-http://localhost:8080/openmrs/ws/fhir2/R4}
 
-
   ollama:
     image: ollama/ollama:latest
     ports:
@@ -357,6 +355,28 @@ services:
     depends_on:
       - medplum-server
 
+  orthanc:
+    image: orthancteam/orthanc:latest
+    ports:
+      # Orthanc web interface and DICOMweb port
+      - "8042:8042"
+      # DICOM store SCU/SCP port (default 4242 in container, 104 is standard, 8104 used in some examples)
+      - "8104:4242"
+    environment:
+      # Enable the web interface and remote access
+      - ORTHANC_JSON={"RemoteAccessAllowed":true,"AuthenticationEnabled":false,"HttpHeaders":{"Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":"GET, POST, PUT, DELETE, OPTIONS","Access-Control-Allow-Headers":"Content-Type"},"HttpRequestTimeout":60}
+    volumes:
+      # Persist the data (DICOM files and database)
+      - orthanc-data:/var/lib/orthanc/
+    restart: unless-stopped
+
+  cors-proxy:
+    image: redocly/cors-anywhere:latest
+    ports:
+      - "8010:8080"
+    restart: "unless-stopped"
+
+
 volumes:
   openmrs-data: ~
   openmrs-db: ~
@@ -368,3 +388,4 @@ volumes:
   ollama-root: ~
   ollama-webui: ~
   mcpx-config: ~
+  orthanc-data: ~

package/dist/resources/genai/app/bootstrap.py

@@ -1,19 +1,49 @@
 from kink import di
-from os import getenv
+import os
 from dotenv import load_dotenv
+from langchain.chat_models import init_chat_model
+from langchain_community.llms.fake import FakeListLLM
 from langchain_core.prompts import PromptTemplate
-from langchain_core.language_models.fake import FakeListLLM
+from langchain_google_genai import ChatGoogleGenerativeAI
+from langchain_openai import ChatOpenAI
 
 ## Override the default configuration of elixirs here if needed
 
 
 def bootstrap():
     load_dotenv()
-    fake_llm = FakeListLLM(responses=["Paris", "I don't know"])
+    di["fhir_access_token"] = os.environ.get(
+        "FHIR_ACCESS_TOKEN", "YWRtaW46QWRtaW4xMjM="
+    )  # admin:Admin123 in base64
+    di["fhir_base_url"] = os.environ.get(
+        "FHIR_BASE_URL", "http://backend:8080/openmrs/ws/fhir2/R4"
+    )
+    # Check if google api key is set in the environment
+    if os.environ.get("GOOGLE_API_KEY"):
+        llm = ChatGoogleGenerativeAI(model="gemini-2.5-flash")
+    # Check if openai api key is set in the environment
+    elif os.environ.get("OPENAI_API_KEY"):
+        llm = ChatOpenAI(model="gpt-4o", temperature=0)
+    else:
+        llm = FakeListLLM(responses=["I am a fake LLM", "I don't know"])
+    di["main_llm"] = llm
+
+    openrouter_api_key = os.environ.get("OPENROUTER_API_KEY")
+    if openrouter_api_key:
+        model = init_chat_model(
+            model="nvidia/nemotron-nano-9b-v2:free",
+            model_provider="openai",
+            base_url="https://openrouter.ai/api/v1",
+            api_key=openrouter_api_key,
+        )
+    else:
+        # Fallback to the main LLM if no OpenRouter API key is configured
+        model = llm
+
+    di["function_llm"] = model
     di["main_prompt"] = PromptTemplate.from_template(
         "Summarize the following in 100 words: {input}"
     )
-    di["main_llm"] = fake_llm
     di["cds_hook_discovery"] = {
         "services": [
             {

package/oclif.manifest.json

@@ -87,12 +87,14 @@
       "aliases": [],
       "args": {
         "op": {
-          "description": "Operation to perform (init, install, or start)",
+          "description": "Operation to perform (add, init, install, or start)",
           "name": "op"
         }
       },
       "description": "Initialize, install, or start OpenMRS frontend development",
       "examples": [
+        "<%= config.bin %> <%= command.id %> add -g my-repo/my-package -n my-package -w ~/projects",
+        "<%= config.bin %> <%= command.id %> add -g my-repo/my-package -b main -n my-package -w ~/projects",
         "<%= config.bin %> <%= command.id %> install -n my-app -w ~/projects",
         "<%= config.bin %> <%= command.id %> init -n my-app -w ~/projects",
         "<%= config.bin %> <%= command.id %> start -n my-app -w ~/projects",
@@ -118,7 +120,7 @@
           "char": "g",
           "description": "GitHub repository to install (for install operation)",
           "name": "git",
-          "default": "dermatologist/openmrs-esm-dhti-template",
+          "default": "dermatologist/openmrs-esm-dhti",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -135,6 +137,7 @@
           "char": "n",
           "description": "Name of the conch",
           "name": "name",
+          "default": "esm-dhti",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -805,5 +808,5 @@
       ]
     }
   },
-  "version": "1.1.0"
+  "version": "1.2.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dhti-cli",
   "description": "DHTI CLI",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "author": "Bell Eapen",
   "bin": {
     "dhti-cli": "bin/run.js"