Files
hold-slayer/config.py
Robert Helewka 63f1a270bb feat: add call history API endpoints and TTS service client
Adds read-only access to persisted call records for the dashboard
and implements a client for the Rhema text-to-speech service.

- api/call_history.py: New router providing paged call lists
  and detailed call records with transcript metadata.
- services/tts.py: Async client for OpenAI-compatible TTS
  endpoints (Rhema/Kokoro) used for call-flow steps.
2026-05-22 06:28:33 -04:00

153 lines
4.3 KiB
Python

"""
Hold Slayer Gateway — Configuration
All settings loaded from environment variables / .env file.
"""
from pydantic import Field
from pydantic_settings import BaseSettings, SettingsConfigDict
class SIPTrunkSettings(BaseSettings):
"""SIP trunk provider configuration."""
model_config = SettingsConfigDict(env_prefix="SIP_TRUNK_")
host: str = "sip.provider.com"
port: int = 5060
username: str = ""
password: str = ""
transport: str = "udp" # udp, tcp, tls
did: str = "" # Your phone number (E.164)
class GatewaySIPSettings(BaseSettings):
"""Gateway SIP listener for device registration."""
model_config = SettingsConfigDict(env_prefix="GATEWAY_SIP_")
host: str = "0.0.0.0"
port: int = 5060
domain: str = "gateway.local"
class SpeachesSettings(BaseSettings):
"""Speaches STT service configuration."""
model_config = SettingsConfigDict(env_prefix="SPEACHES_")
url: str = "http://localhost:22070"
model: str = "whisper-large-v3"
class ClassifierSettings(BaseSettings):
"""Audio classifier thresholds."""
model_config = SettingsConfigDict(env_prefix="CLASSIFIER_")
music_threshold: float = 0.7
speech_threshold: float = 0.6
silence_threshold: float = 0.85
window_seconds: float = 3.0
class LLMSettings(BaseSettings):
"""LLM service configuration (OpenAI-compatible API)."""
model_config = SettingsConfigDict(env_prefix="LLM_")
base_url: str = "http://localhost:11434/v1"
model: str = "llama3"
api_key: str = "not-needed"
timeout: float = 30.0
max_tokens: int = 1024
temperature: float = 0.3
class HoldSlayerSettings(BaseSettings):
"""Hold Slayer behavior settings."""
model_config = SettingsConfigDict(env_prefix="HOLD_SLAYER_", env_prefix_allow_empty=True)
default_transfer_device: str = Field(
default="sip_phone", validation_alias="DEFAULT_TRANSFER_DEVICE"
)
max_hold_time: int = Field(default=7200, validation_alias="MAX_HOLD_TIME")
hold_check_interval: float = Field(default=2.0, validation_alias="HOLD_CHECK_INTERVAL")
class TTSSettings(BaseSettings):
"""Rhema TTS service configuration (OpenAI-compatible /v1/audio/speech)."""
model_config = SettingsConfigDict(env_prefix="TTS_")
base_url: str = "http://localhost:8000"
model: str = "speaches-ai/Kokoro-82M-v1.0-ONNX"
voice: str = "af_heart"
api_key: str = ""
timeout: float = 30.0
sample_rate: int = 16000
class ReceptionistSettings(BaseSettings):
"""AI Receptionist behavior settings."""
model_config = SettingsConfigDict(env_prefix="RECEPTIONIST_")
enabled: bool = True
greeting_template: str = (
"Hi, you've reached Robert's line. Who's calling, and what's this about?"
)
message_prompt: str = "Please leave your message after the tone."
listen_timeout_s: float = 15.0
end_of_utterance_silence_s: float = 1.2
message_max_seconds: int = 90
llm_persona: str = (
"You are a helpful, concise phone receptionist. Decide whether to ring "
"the owner, take a message, or politely decline."
)
class Settings(BaseSettings):
"""Root application settings."""
model_config = SettingsConfigDict(
env_file=".env",
env_file_encoding="utf-8",
extra="ignore",
)
# Database
database_url: str = "postgresql+asyncpg://holdslayer:changeme@localhost:5432/holdslayer"
# Server
host: str = "0.0.0.0"
port: int = 8000
debug: bool = True
log_level: str = "info"
# Notifications
notify_sms_number: str = ""
# Sub-configs
sip_trunk: SIPTrunkSettings = Field(default_factory=SIPTrunkSettings)
gateway_sip: GatewaySIPSettings = Field(default_factory=GatewaySIPSettings)
speaches: SpeachesSettings = Field(default_factory=SpeachesSettings)
classifier: ClassifierSettings = Field(default_factory=ClassifierSettings)
llm: LLMSettings = Field(default_factory=LLMSettings)
hold_slayer: HoldSlayerSettings = Field(default_factory=HoldSlayerSettings)
tts: TTSSettings = Field(default_factory=TTSSettings)
receptionist: ReceptionistSettings = Field(default_factory=ReceptionistSettings)
# Singleton
_settings: Settings | None = None
def get_settings() -> Settings:
"""Get cached application settings."""
global _settings
if _settings is None:
_settings = Settings()
return _settings