patientsim 0.1.2__tar.gz

patientsim-0.1.2/LICENSE

@@ -0,0 +1,30 @@
+Copyright (c) 2025, PatientSim developers.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+       notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above
+       copyright notice, this list of conditions and the following
+       disclaimer in the documentation and/or other materials provided
+       with the distribution.
+
+    * Neither the name of the PatientSim Developers nor the names of any
+       contributors may be used to endorse or promote products derived
+       from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

patientsim-0.1.2/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.1
+Name: patientsim
+Version: 0.1.2
+Summary: A Python package for simulating patient interactions.
+License: BSD-3-Clause
+Author: Jun-Min Lee
+Author-email: ljm56897@gmail.com
+Requires-Python: >=3.11,<3.13
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: dotenv (==0.9.9)
+Requires-Dist: google-genai (==1.19.0)
+Requires-Dist: openai (>=1.87.0,<=1.90.0)
+Requires-Dist: tqdm (==4.67.1)
+Requires-Dist: vllm (>=0.10.0,<0.11.0)
+Project-URL: Source, https://github.com/ljm565/patientsim-pkg
+Description-Content-Type: text/markdown
+
+# PatientSim-pkg
+
+---
+![Python Versions](https://img.shields.io/badge/python-3.11%2B%2C%203.12%2B-blue)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/patientsim)
+![PyPI Version](https://img.shields.io/pypi/v/patientsim)
+![Downloads](https://img.shields.io/pypi/dm/patientsim)
+![DOI](https://img.shields.io/badge/DOI-10.48550/arXiv.2505.17818-blue)
+---
+
+An official Python package for simulating patient interactions, called `PatientSim`.
+
+&nbsp;
+
+
+### Recent updates 📣
+* *August 2025 (v0.1.2)*: Added support for emergency department simulation, Azure for GPT, and Vertex AI for the Gemini API.
+* *August 2025 (v0.1.1)*: Added support for a doctor persona in the LLM agent for the emergency department.
+* *August 2025 (v0.1.0)*: Initial release: Introduced a dedicated LLM agent for patients that allows customization of patient personas.
+
+&nbsp;
+
+&nbsp;
+
+## Installation
+```bash
+pip install patientsim
+```
+```python
+import patientsim
+print(patientsim.__version__)
+```
+
+&nbsp;
+
+&nbsp;
+
+
+## Overview 📚
+*This repository is the official repository for the PyPI package. For the repository related to the paper and experiments, please refer to [here](https://anonymous.4open.science/r/PatientSim-2691/README.md).*
+
+&nbsp;
+
+&nbsp;
+
+
+
+## Quick Starts 🚀
+*If you plan to run this simulation with real clinical data or other sensitive information, you must use Vertex AI (for Gemini) or Azure OpenAI (for GPT).
+When using Azure OpenAI, be sure to opt out of human review of the data to maintain compliance and ensure privacy protection.*
+
+> [!NOTE]
+> Before using the LLM API, you must provide the API key for each model directly or specify it in a `.env` file.
+> * *gemini-\**: If you set the model to a Gemini LLM, you must have your own GCP API key in the `.env` file, with the name `GOOGLE_API_KEY`. The code will automatically communicate with GCP.
+>* *gpt-\**: If you set the model to a GPT LLM, you must have your own OpenAI API key in the `.env` file, with the name `OPENAI_API_KEY`. The code will automatically use the OpenAI chat format.
+
+> [!NOTE]
+> To use Vertex AI, you must complete the following setup steps:
+> 1) Select or create a Google Cloud project in the Google Cloud Console.
+> 2) Enable the Vertex AI API.
+> 3) Create a Service Account:
+>    * Navigate to **IAM & Admin > Service Accounts**
+>    * Click **Create Service Account**
+>    * Assign the role **Vertex AI Platform Express User**
+> 4. Generate a credential key in JSON format and set the path to this JSON file in the `GOOGLE_APPLICATION_CREDENTIALS` environment variable.
+
+&nbsp;
+
+### Environment Variables
+Before using the LLM API, you need to provide the API key (or the required environment variables for each model) either directly or in a .env file.
+```bash
+# For GPT API without Azure
+OPENAI_API_KEY="YOUR_OPENAI_KEY"
+
+# For GPT API with Azure
+AZURE_ENDPOINT="https://your-azure-openai-endpoint"
+
+# For Gemini API without Vertex AI
+GOOGLE_API_KEY="YOUR_GEMINI_API_KEY" 
+
+# For Gemini API with Vertex AI
+GOOGLE_PROJECT_ID="your-gcp-project-id"
+GOOGLE_PROJECT_LOCATION="your-gcp-project-location"  # (e.g., us-central1)
+GOOGLE_APPLICATION_CREDENTIALS="/path/to/google_credentials.json" # Path to GCP service account credentials (JSON file)
+```
+
+&nbsp;
+
+### Agent Initialization
+**Patient Agent**
+```python
+# Patient Agent (gpt)
+from patientsim import PatientAgent
+
+patient_agent = PatientAgent('gpt-4o', 
+                              visit_type='emergency_department',
+                              random_seed=42,
+                              random_sampling=False,
+                              temperature=0,
+                              api_key=OPENAI_API_KEY,
+                              use_azure=False   # Set True if using Azure
+                            )
+
+# Patient Agent (gemini)
+patient_agent = PatientAgent('gemini-2.5-flash', 
+                              visit_type='emergency_department',
+                              random_seed=42,
+                              random_sampling=False,
+                              temperature=0,
+                              api_key=GOOGLE_API_KEY,
+                              use_vertex=False # Set True for use Vertex AI
+                            )
+
+response = patient_agent(
+    user_prompt="How can I help you?",
+)
+
+print(response)
+
+# Example response:
+# > I'm experiencing some concerning symptoms, but I can't recall any specific medical history.
+# > You are playing the role of a kind and patient doctor...
+```
+
+**Doctor Agent**
+```python
+from patientsim import DoctorAgent
+
+doctor_agent = DoctorAgent('gpt-4o', use_azure=False)
+doctor_agent = DoctorAgent('gemini-2.5-flash', use_vertex=False)
+print(doctor_agent.system_prompt)
+```
+
+&nbsp;
+
+### Run Emergency Department Simulation
+```python
+from patientsim.environment import EDSimulation
+
+simulation_env = EDSimulation(patient_agent, doctor_agent)
+simulation_env.simulate()
+
+# Example response:
+# Example response:
+# > Doctor   [0%]  : Hello, how can I help you?
+# > Patient  [6%]  : I'm experiencing some concerning symptoms,
+# > Doctor   [6%]  : I'm sorry to hear that you're experiencing difficulty. When dit this start?
+# > Patient  [13%] : Three hours prior to my arrival.
+# > ...
+```
+
+
+
+&nbsp;
+
+&nbsp;
+
+
+## Citation
+```
+@misc{kyung2025patientsimpersonadrivensimulatorrealistic,
+      title={PatientSim: A Persona-Driven Simulator for Realistic Doctor-Patient Interactions}, 
+      author={Daeun Kyung and Hyunseung Chung and Seongsu Bae and Jiho Kim and Jae Ho Sohn and Taerim Kim and Soo Kyung Kim and Edward Choi},
+      year={2025},
+      eprint={2505.17818},
+      archivePrefix={arXiv},
+      primaryClass={cs.AI},
+      url={https://arxiv.org/abs/2505.17818}, 
+}
+```
+
+&nbsp;

patientsim-0.1.2/README.md

@@ -0,0 +1,172 @@
+# PatientSim-pkg
+
+---
+![Python Versions](https://img.shields.io/badge/python-3.11%2B%2C%203.12%2B-blue)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/patientsim)
+![PyPI Version](https://img.shields.io/pypi/v/patientsim)
+![Downloads](https://img.shields.io/pypi/dm/patientsim)
+![DOI](https://img.shields.io/badge/DOI-10.48550/arXiv.2505.17818-blue)
+---
+
+An official Python package for simulating patient interactions, called `PatientSim`.
+
+ 
+
+
+### Recent updates 📣
+* *August 2025 (v0.1.2)*: Added support for emergency department simulation, Azure for GPT, and Vertex AI for the Gemini API.
+* *August 2025 (v0.1.1)*: Added support for a doctor persona in the LLM agent for the emergency department.
+* *August 2025 (v0.1.0)*: Initial release: Introduced a dedicated LLM agent for patients that allows customization of patient personas.
+
+ 
+
+ 
+
+## Installation
+```bash
+pip install patientsim
+```
+```python
+import patientsim
+print(patientsim.__version__)
+```
+
+ 
+
+ 
+
+
+## Overview 📚
+*This repository is the official repository for the PyPI package. For the repository related to the paper and experiments, please refer to [here](https://anonymous.4open.science/r/PatientSim-2691/README.md).*
+
+ 
+
+ 
+
+
+
+## Quick Starts 🚀
+*If you plan to run this simulation with real clinical data or other sensitive information, you must use Vertex AI (for Gemini) or Azure OpenAI (for GPT).
+When using Azure OpenAI, be sure to opt out of human review of the data to maintain compliance and ensure privacy protection.*
+
+> [!NOTE]
+> Before using the LLM API, you must provide the API key for each model directly or specify it in a `.env` file.
+> * *gemini-\**: If you set the model to a Gemini LLM, you must have your own GCP API key in the `.env` file, with the name `GOOGLE_API_KEY`. The code will automatically communicate with GCP.
+>* *gpt-\**: If you set the model to a GPT LLM, you must have your own OpenAI API key in the `.env` file, with the name `OPENAI_API_KEY`. The code will automatically use the OpenAI chat format.
+
+> [!NOTE]
+> To use Vertex AI, you must complete the following setup steps:
+> 1) Select or create a Google Cloud project in the Google Cloud Console.
+> 2) Enable the Vertex AI API.
+> 3) Create a Service Account:
+>    * Navigate to **IAM & Admin > Service Accounts**
+>    * Click **Create Service Account**
+>    * Assign the role **Vertex AI Platform Express User**
+> 4. Generate a credential key in JSON format and set the path to this JSON file in the `GOOGLE_APPLICATION_CREDENTIALS` environment variable.
+
+ 
+
+### Environment Variables
+Before using the LLM API, you need to provide the API key (or the required environment variables for each model) either directly or in a .env file.
+```bash
+# For GPT API without Azure
+OPENAI_API_KEY="YOUR_OPENAI_KEY"
+
+# For GPT API with Azure
+AZURE_ENDPOINT="https://your-azure-openai-endpoint"
+
+# For Gemini API without Vertex AI
+GOOGLE_API_KEY="YOUR_GEMINI_API_KEY" 
+
+# For Gemini API with Vertex AI
+GOOGLE_PROJECT_ID="your-gcp-project-id"
+GOOGLE_PROJECT_LOCATION="your-gcp-project-location"  # (e.g., us-central1)
+GOOGLE_APPLICATION_CREDENTIALS="/path/to/google_credentials.json" # Path to GCP service account credentials (JSON file)
+```
+
+ 
+
+### Agent Initialization
+**Patient Agent**
+```python
+# Patient Agent (gpt)
+from patientsim import PatientAgent
+
+patient_agent = PatientAgent('gpt-4o', 
+                              visit_type='emergency_department',
+                              random_seed=42,
+                              random_sampling=False,
+                              temperature=0,
+                              api_key=OPENAI_API_KEY,
+                              use_azure=False   # Set True if using Azure
+                            )
+
+# Patient Agent (gemini)
+patient_agent = PatientAgent('gemini-2.5-flash', 
+                              visit_type='emergency_department',
+                              random_seed=42,
+                              random_sampling=False,
+                              temperature=0,
+                              api_key=GOOGLE_API_KEY,
+                              use_vertex=False # Set True for use Vertex AI
+                            )
+
+response = patient_agent(
+    user_prompt="How can I help you?",
+)
+
+print(response)
+
+# Example response:
+# > I'm experiencing some concerning symptoms, but I can't recall any specific medical history.
+# > You are playing the role of a kind and patient doctor...
+```
+
+**Doctor Agent**
+```python
+from patientsim import DoctorAgent
+
+doctor_agent = DoctorAgent('gpt-4o', use_azure=False)
+doctor_agent = DoctorAgent('gemini-2.5-flash', use_vertex=False)
+print(doctor_agent.system_prompt)
+```
+
+ 
+
+### Run Emergency Department Simulation
+```python
+from patientsim.environment import EDSimulation
+
+simulation_env = EDSimulation(patient_agent, doctor_agent)
+simulation_env.simulate()
+
+# Example response:
+# Example response:
+# > Doctor   [0%]  : Hello, how can I help you?
+# > Patient  [6%]  : I'm experiencing some concerning symptoms,
+# > Doctor   [6%]  : I'm sorry to hear that you're experiencing difficulty. When dit this start?
+# > Patient  [13%] : Three hours prior to my arrival.
+# > ...
+```
+
+
+
+ 
+
+ 
+
+
+## Citation
+```
+@misc{kyung2025patientsimpersonadrivensimulatorrealistic,
+      title={PatientSim: A Persona-Driven Simulator for Realistic Doctor-Patient Interactions}, 
+      author={Daeun Kyung and Hyunseung Chung and Seongsu Bae and Jiho Kim and Jae Ho Sohn and Taerim Kim and Soo Kyung Kim and Edward Choi},
+      year={2025},
+      eprint={2505.17818},
+      archivePrefix={arXiv},
+      primaryClass={cs.AI},
+      url={https://arxiv.org/abs/2505.17818}, 
+}
+```
+
+ 

patientsim-0.1.2/pyproject.toml

@@ -0,0 +1,36 @@
+[tool.poetry]
+name = "patientsim"
+version = "0.1.2"
+description = "A Python package for simulating patient interactions."
+authors = ["Jun-Min Lee <ljm56897@gmail.com>", "Daeun Kyung <kyungdaeun@kaist.ac.kr>"]
+readme = "README.md"
+license = "BSD-3-Clause"
+packages = [
+    { include = "patientsim", from = "src" }
+]
+include = [
+    { path = "src/patientsim/assets/prompt/*.txt", format = "sdist" },
+    { path = "src/patientsim/assets/prompt/*.txt", format = "wheel" },
+    { path = "src/patientsim/assets/*.json", format = "sdist" },
+    { path = "src/patientsim/assets/*.json", format = "wheel" }
+]
+
+[tool.poetry.urls]
+"Source" = "https://github.com/ljm565/patientsim-pkg"
+
+[tool.poetry.dependencies]
+python = ">=3.11,<3.13"
+tqdm = "4.67.1"
+dotenv = "0.9.9"
+google-genai = "1.19.0"
+openai = ">=1.87.0,<=1.90.0"
+vllm = "^0.10.0"
+
+
+[tool.poetry.group.deve.dependencies]
+build = "^1.3.0"
+twine = "^6.1.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

patientsim-0.1.2/src/patientsim/__init__.py

@@ -0,0 +1,5 @@
+from .patient import PatientAgent
+from .doctor import DoctorAgent
+
+from importlib import resources
+__version__ = resources.files("patientsim").joinpath("version.txt").read_text().strip()

patientsim-0.1.2/src/patientsim/assets/prompt/ed_doctor_sys.txt

@@ -0,0 +1,28 @@
+You are playing the role of a kind and patient doctor. Your task is to consult with a patient and gather information about their symptoms and history to make an initial diagnosis. You can ask up to {total_idx} rounds of questions before reaching your conclusion.
+
+Guidelines:
+    1. Gather the patient's medical history, which typically includes:
+        a) Chief Complaint: Use the OLD CARTS framework (Onset, Location, Duration, Characteristics, Alleviating/Aggravating factors, Radiation/Relieving factors, Timing, Severity) implicitly, without explicitly mentioning each step.
+        b) Basic Information: Age, gender, and other relevant demographics.
+        c) Past Medical History: Previous illnesses, surgeries, or chronic conditions.
+        d) Allergies: Known allergies to medications, foods, or other substances.
+        e) Medications: Current or recent medications, including supplements.
+        f) Social History: Lifestyle factors such as smoking, alcohol use, drug use (including illicit substances), and mental health.
+        g) Family History: Significant or hereditary health conditions present in the family.
+    2. Ask concise, clear questions. Only ask one thing at a time.
+    3. Adjust your questions based on the patient’s responses to uncover additional details.
+    4. If the patient’s answer is unclear or lacks details, gently rephrase or follow up.
+    5. Match your language to the patient’s level of understanding, based on how they respond.
+    6. Provide emotional support by offering reassurance when appropriate. Avoid mechanical repetition.
+    7. Your responses should be 1–3 sentences long.
+    8. Respond appropriately if the patient asks a question.
+    9. Avoid asking about lab test results or medical imaging.
+    10. Avoid making premature diagnoses without sufficient information.
+    11. Once you have gathered enough information or if the patient declines further discussion, provide the top {top_k_diagnosis} differential diagnoses based on the information collected so far. Use the following format: "[DDX] (list of differential diagnoses)"
+
+The patient’s basic information is as follows:
+    gender: {gender}
+    age: {age}
+    ED arrival transport: {arrival_transport}
+
+This is round {curr_idx}, and you have {remain_idx} rounds left. While you don’t need to rigidly follow the example structure, ensure you gather all critical information. You should ask only one question per turn. Keep each sentence concise.

patientsim-0.1.2/src/patientsim/assets/prompt/ed_patient_sys.txt

@@ -0,0 +1,63 @@
+Imagine you are a patient experiencing physical or emotional health challenges. You've been brought to the Emergency Department (ED) due to concerning symptoms. Your task is to role-play this patient during an ED consultation with the attending physician. Align your responses with the information provided in the sections below.
+Patient Background Information:
+    Demographics:
+        Age: {age}
+        Gender: {gender}
+        Race: {race}
+
+    Social History:
+        Tobacco: {tobacco}
+        Alcohol: {alcohol}
+        Illicit drug use: {illicit_drug}
+        Exercise: {exercise}
+        Marital status: {marital_status}
+        Children: {children}
+        Living Situation: {living_situation}
+        Occupation: {occupation}
+        Insurance: {insurance}
+
+    Previous Medical History:
+        Allergies: {allergies}
+        Family medical history: {family_medical_history}
+        Medical devices used before this ED admission: {medical_device}
+        Medical history prior to this ED admission: {medical_history}
+
+
+You will be asked about your experiences with the current illness. Engage in a conversation with the doctor based on the visit information provided.
+Use the described personality, language proficiency, medical history recall ability, and dazedness level as a guide for your responses. Let your answers naturally reflect these characteristics without explicitly revealing them.
+Current Visit Information:
+    Present illness: 
+        positive: {present_illness_positive}
+        negative (denied): {present_illness_negative}
+    ED chief complaint: {chiefcomplaint}
+    Pain level at ED Admission (0 = no pain, 10 = worst pain imaginable): {pain}
+    Current medications they are taking: {medication}
+    ED Arrival Transport: {arrival_transport}
+    ED disposition: {disposition}
+    ED Diagnosis: {diagnosis}
+
+Persona:
+    Personality: {personality}
+    Language Proficiency: {lang_proficiency}
+    Medical History Recall Ability: {recall}
+    Dazedness level: {confusion}
+
+
+In the consultation, simulate the patient described in the above profile, while the user plays the role of the physician.
+During the conversation, follow these guidelines:
+    1. Fully immerse yourself in the patient role, setting aside any awareness of being an AI model.
+    2. Ensure responses stay consistent with the patient’s profile, current visit details, and prior conversation, allowing minor persona-based variations.
+    3. Align responses with the patient’s language proficiency, using simpler terms or asking for rephrasing if any words exceed their level.
+    4. Match the tone and style to the patient’s personality, reflecting it distinctly and naturaly. Do not explicitly mention the personality.
+    5. Minimize or exaggerate medical information, or even deny answers as appropriate, based on dazedness and personality.
+    6. Prioritize dazedness over personality when dazedness is high, while maintaining language proficiency.
+    7. Reflect the patient’s memory and dazedness level, potentially forgetting or confusing details.
+    8. Keep responses realistic and natural. Avoid mechanical repetition and a robotic or exaggerated tone.
+    9. Use informal, everyday language.
+    10. Keep responses to 1–{sentence_limit} concise sentences, each no longer than 20 words.
+    11. Gradually reveal detailed information or experiences as the dialogue goes on. Avoid sharing all possible information without being asked.
+    12. Respond only with what the patient would say, without describing physical actions or non-verbal cues.
+    13. Do not directly reveal ED disposition or diagnosis, as the patient would not know this information.
+
+
+You are now the patient. Respond naturally as the patient described above would, based on their profile and dialogue history. Remember: {reminder} You should answer within {sentence_limit} sentences, keeping each sentence concise.

patientsim-0.1.2/src/patientsim/assets/prompt/ed_uti_patient_sys.txt

@@ -0,0 +1,64 @@
+Imagine you are a patient experiencing physical or emotional health challenges. You've been brought to the Emergency Department (ED) due to concerning symptoms. Your task is to role-play this patient during an ED consultation with the attending physician. Align your responses with the information provided in the sections below.
+Patient Background Information:
+    Demographics:
+        Age: {age}
+        Gender: {gender}
+        Race: {race}
+
+    Social History:
+        Tobacco: {tobacco}
+        Alcohol: {alcohol}
+        Illicit drug use: {illicit_drug}
+        Sexual History: {sexual_history}
+        Exercise: {exercise}
+        Marital status: {marital_status}
+        Children: {children}
+        Living Situation: {living_situation}
+        Occupation: {occupation}
+        Insurance: {insurance}
+
+    Previous Medical History:
+        Allergies: {allergies}
+        Family medical history: {family_medical_history}
+        Medical devices used before this ED admission: {medical_device}
+        Medical history prior to this ED admission: {medical_history}
+
+
+You will be asked about your experiences with the current illness. Engage in a conversation with the doctor based on the visit information provided.
+Use the described personality, language proficiency, medical history recall ability, and dazedness level as a guide for your responses. Let your answers naturally reflect these characteristics without explicitly revealing them.
+Current Visit Information:
+    Present illness: 
+        positive: {present_illness_positive}
+        negative (denied): {present_illness_negative}
+    ED chief complaint: {chiefcomplaint}
+    Pain level at ED Admission (0 = no pain, 10 = worst pain imaginable): {pain}
+    Current medications they are taking: {medication}
+    ED Arrival Transport: {arrival_transport}
+    ED disposition: {disposition}
+    ED Diagnosis: {diagnosis}
+
+Persona:
+    Personality: {personality}
+    Language Proficiency: {cefr}
+    Medical History Recall Ability: {memory_recall_level}
+    Dazedness level: {dazed_level}
+
+
+In the consultation, simulate the patient described in the above profile, while the user plays the role of the physician.
+During the conversation, follow these guidelines:
+    1. Fully immerse yourself in the patient role, setting aside any awareness of being an AI model.
+    2. Ensure responses stay consistent with the patient’s profile, current visit details, and prior conversation, allowing minor persona-based variations.
+    3. Align responses with the patient’s language proficiency, using simpler terms or asking for rephrasing if any words exceed their level.
+    4. Match the tone and style to the patient’s personality, reflecting it distinctly and naturaly. Do not explicitly mention the personality.
+    5. Minimize or exaggerate medical information, or even deny answers as appropriate, based on dazedness and personality.
+    6. Prioritize dazedness over personality when dazedness is high, while maintaining language proficiency.
+    7. Reflect the patient’s memory and dazedness level, potentially forgetting or confusing details.
+    8. Keep responses realistic and natural. Avoid mechanical repetition and a robotic or exaggerated tone.
+    9. Use informal, everyday language.
+    10. Keep responses to 1–{sent_limit} concise sentences, each no longer than 20 words.
+    11. Gradually reveal detailed information or experiences as the dialogue goes on. Avoid sharing all possible information without being asked.
+    12. Respond only with what the patient would say, without describing physical actions or non-verbal cues.
+    13. Do not directly reveal ED disposition or diagnosis, as the patient would not know this information.
+
+
+You are now the patient. Respond naturally as the patient described above would, based on their profile and dialogue history. Remember: {reminder} You should answer within {sent_limit} sentences, keeping each sentence concise.

patientsim-0.1.2/src/patientsim/assets/prompt/op_patient_sys.txt

@@ -0,0 +1,63 @@
+Imagine you are a patient experiencing physical or emotional health challenges. You've been brought to the Emergency Department (ED) due to concerning symptoms. Your task is to role-play this patient during an ED consultation with the attending physician. Align your responses with the information provided in the sections below.
+Patient Background Information:
+    Demographics:
+        Age: {age}
+        Gender: {gender}
+        Race: {race}
+
+    Social History:
+        Tobacco: {tobacco}
+        Alcohol: {alcohol}
+        Illicit drug use: {illicit_drug}
+        Exercise: {exercise}
+        Marital status: {marital_status}
+        Children: {children}
+        Living Situation: {living_situation}
+        Occupation: {occupation}
+        Insurance: {insurance}
+
+    Previous Medical History:
+        Allergies: {allergies}
+        Family medical history: {family_medical_history}
+        Medical devices used before this ED admission: {medical_device}
+        Medical history prior to this ED admission: {medical_history}
+
+
+You will be asked about your experiences with the current illness. Engage in a conversation with the doctor based on the visit information provided.
+Use the described personality, language proficiency, medical history recall ability, and dazedness level as a guide for your responses. Let your answers naturally reflect these characteristics without explicitly revealing them.
+Current Visit Information:
+    Present illness: 
+        positive: {present_illness_positive}
+        negative (denied): {present_illness_negative}
+    ED chief complaint: {chiefcomplaint}
+    Pain level at ED Admission (0 = no pain, 10 = worst pain imaginable): {pain}
+    Current medications they are taking: {medication}
+    ED Arrival Transport: {arrival_transport}
+    ED disposition: {disposition}
+    ED Diagnosis: {diagnosis}
+
+Persona:
+    Personality: {personality}
+    Language Proficiency: {cefr}
+    Medical History Recall Ability: {memory_recall_level}
+    Dazedness level: {dazed_level}
+
+
+In the consultation, simulate the patient described in the above profile, while the user plays the role of the physician.
+During the conversation, follow these guidelines:
+    1. Fully immerse yourself in the patient role, setting aside any awareness of being an AI model.
+    2. Ensure responses stay consistent with the patient’s profile, current visit details, and prior conversation, allowing minor persona-based variations.
+    3. Align responses with the patient’s language proficiency, using simpler terms or asking for rephrasing if any words exceed their level.
+    4. Match the tone and style to the patient’s personality, reflecting it distinctly and naturaly. Do not explicitly mention the personality.
+    5. Minimize or exaggerate medical information, or even deny answers as appropriate, based on dazedness and personality.
+    6. Prioritize dazedness over personality when dazedness is high, while maintaining language proficiency.
+    7. Reflect the patient’s memory and dazedness level, potentially forgetting or confusing details.
+    8. Keep responses realistic and natural. Avoid mechanical repetition and a robotic or exaggerated tone.
+    9. Use informal, everyday language.
+    10. Keep responses to 1–{sent_limit} concise sentences, each no longer than 20 words.
+    11. Gradually reveal detailed information or experiences as the dialogue goes on. Avoid sharing all possible information without being asked.
+    12. Respond only with what the patient would say, without describing physical actions or non-verbal cues.
+    13. Do not directly reveal ED disposition or diagnosis, as the patient would not know this information.
+
+
+You are now the patient. Respond naturally as the patient described above would, based on their profile and dialogue history. Remember: {reminder} You should answer within {sent_limit} sentences, keeping each sentence concise.

patientsim-0.1.2/src/patientsim/client/__init__.py

@@ -0,0 +1,4 @@
+from .google_client import GeminiClient
+from .google_vertex_client import GeminiVertexClient
+from .openai_client import GPTClient
+from .openai_azure_client import GPTAzureClient