Skip to content

CTCycle/DILIGENT-Clinical-Copilot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

762 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DILIGENT Clinical Copilot

Release Python Angular License CI

1. Project Overview

DILIGENT Clinical Copilot supports clinicians during Drug-Induced Liver Injury (DILI) evaluations with a FastAPI backend and an Angular + TypeScript frontend. It collects anamnesis, medications, and lab values, then coordinates clinical analysis with optional RAG support and session persistence for review.

Work in Progress: This project is under active development and may contain incomplete features or defects.

2. Quick Start

2.1 Windows (Recommended)

Run:

DILIGENT\start_on_windows.bat

The launcher prepares local runtimes/dependencies and starts backend plus frontend.

2.2 macOS / Linux (Manual)

Prerequisites:

  • Python 3.14+
  • Node.js 18+ and npm

Backend:

python -m venv runtimes/.venv
source runtimes/.venv/bin/activate
pip install --upgrade pip
pip install -e .
uvicorn DILIGENT.server.app:app --host 127.0.0.1 --port 8000

Frontend:

cd DILIGENT/client
npm install
npm run build
npm run preview -- --host 127.0.0.1 --port 7861

3. Runtime Profiles

DILIGENT is configuration-first and uses one active runtime file: DILIGENT/settings/.env.

Switch to local profile:

copy /Y DILIGENT\settings\.env.local.example DILIGENT\settings\.env

Switch to local Tauri profile:

copy /Y DILIGENT\settings\.env.local.tauri.example DILIGENT\settings\.env

See assets/docs/PACKAGING_AND_RUNTIME_MODES.md for full runtime and packaging details.

4. Using the Application

Typical workflow:

  1. Enter anamnesis, exam notes, medications, and lab values.
  2. Choose model/provider settings and optionally enable RAG/web search.
  3. Run analysis and review the generated report.
  4. Use Data Inspection for session history and data-update operations.

Detailed user journeys and feature guidance are documented in assets/docs/USER_MANUAL.md.

Screenshots

Landing Page

Landing page Main DILI analysis workspace with clinical inputs and patient context panel.

Dashboard / Report Output

Dashboard view Analysis dashboard focused on the report output area and execution controls.

Model Configuration (Settings)

Model settings Runtime source selection and current model configuration summary.

Local Model Catalog (List)

Model list Scrollable local model catalog with install and role-assignment actions.

Provider Access Key Management

Provider key detail Tavily access-key management entry point within the configuration panel.

Data Inspection

Data inspection Session inspection table with status, timing, and record actions.

5. Desktop Packaging (Tauri)

Build Windows desktop artifacts:

release\tauri\build_with_tauri.bat

Generated outputs:

  • release/windows/installers
  • release/windows/portable

6. Setup and Maintenance

Run:

DILIGENT\setup_and_maintenance.bat

Use this script for offline maintenance operations (for example DB initialization and cleanup tasks).

7. Documentation Map

  • assets/docs/USER_MANUAL.md: end-user operation, journeys, key commands.
  • assets/docs/ARCHITECTURE.md: system boundaries and data flow.
  • assets/docs/BACKGROUND_JOBS.md: job lifecycle and semantics.
  • assets/docs/PACKAGING_AND_RUNTIME_MODES.md: runtime profiles and packaging.
  • assets/docs/ERROR_HANDLING.md: backend/frontend error strategy.
  • assets/docs/UI_STANDARDS.md: frontend design standards.

8. License

Non-commercial use is covered by the Polyform Noncommercial License 1.0.0; commercial licensing is available separately. See LICENSE.

About

An AI-powered clinical copilot designed to assist physicians in detecting and managing Drug-Induced Liver Injury (DILI), leveraging the capabilities of large language models (LLMs).

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors