Configuration

PatientHub uses Hydra for configuration management, making it easy to override settings from the command line or config files.

Environment Variables

Create a .env file in the project root:

{model_type}_API_KEY=api_key_for_the_service
{model_type}_BASE_URL=base_url_for_the_service

For example,

# For OpenAI (default)
OPENAI_API_KEY=your_openai_key
OPENAI_BASE_URL=https://api.openai.com

# For VLLM (n this case, model_type = VLLM)
VLLM_BASE_URL=http://127.0.0.1
VLLM_API_KEY=None

Model Configuration

Using OpenAI (Default)

config = {
    'model_type': 'OPENAI',
    'model_name': 'gpt-4o',
    'temperature': 0.7,
    'max_tokens': 1024,
    'max_retries': 3,
}

Client Configuration

Common Options

Option	Type	Default	Description
agent_type	str	required	Agent type identifier
model_type	str	"OPENAI"	Model provider
model_name	str	"gpt-4o"	Model identifier
temperature	float	0.7	Sampling temperature
max_tokens	int	1024	Max response tokens
max_retries	int	3	API retry attempts
data_path	str	varies	Path to character JSON
data_idx	int	0	Index in character file
lang	str	"en"	Language

Client-Specific Options

ConsistentMI

client:
  agent_type: consistentMI
  initial_stage: precontemplation # precontemplation, contemplation, preparation, action

SimPatient

client:
  agent_type: simPatient
  continue_last_session: false
  conv_history_path: data/sessions/SimPatient/session_1.json

Session Configuration

event:
  event_type: therapySession
  max_turns: 30
  reminder_turn_num: 5
  output_dir: data/sessions/default/session_1.json

Evaluation Configuration

evaluator:
  agent_type: llm_judge
  eval_type: scalar # classification | scalar | binary | extraction
  target: client # client or therapist
  instruction_dir: data/prompts/evaluator/client/scalar.yaml
  granularity: session # session | turn | turn_by_turn
  use_reasoning: false

Command Line Overrides

Override any config value from the command line:

# Single override
uv run python -m examples.simulate client.temperature=0.5

# Multiple overrides
uv run python -m examples.simulate \
  client=patientPsi \
  client.temperature=0.5 \
  therapist=CBT \
  event.max_turns=50

# Override nested values
uv run python -m examples.simulate client.data_idx=2

Config Files

Create custom config files in the appropriate directories:

Custom Client Config

Create configs/client/myclient.yaml:

agent_type: patientPsi
model_type: OPENAI
model_name: gpt-4o
temperature: 0.5
max_tokens: 2048
data_path: data/characters/PatientPsi.json
data_idx: 0

Use it:

uv run python -m examples.simulate client=myclient

Debugging

Enable debug output:

# Show full config
uv run python -m examples.simulate --cfg job

# Show config sources
uv run python -m examples.simulate --info