# Issue #26 — Add `pydantic-settings` env loader for all config

[Devnil434]

Description

Configuration is currently scattered across:

• .env.example
• hardcoded constants
• inline threshold values

Centralize all configuration into:

libs/config/settings.py

using pydantic-settings.

---

File to Create

from pydantic_settings import BaseSettings

class Settings(BaseSettings):
    redis_url: str = "redis://localhost:6379"
    max_events_per_track: int = 50
    track_ttl_seconds: int = 300

    lingering_threshold_sec: float = 5.0
    movement_threshold_px: float = 8.0
    near_keypad_dist_px: float = 80.0

    keypad_center_x: float = 600.0
    keypad_center_y: float = 280.0

    yolo_model: str = "yolov8n.pt"
    confidence_threshold: float = 0.45

    tracker_max_age: int = 30
    tracker_n_init: int = 3

    class Config:
        env_file = ".env"

settings = Settings()

---

Files to Touch

libs/config/settings.py
services/memory/action_classifier.py
.env.example
tests/test_settings.py

---

Acceptance Criteria

• Remove hardcoded thresholds from production code
• Use centralized settings
• .env.example updated
• Environment overrides tested
• Existing tests remain green

[zoha-dev]

Hi @Devnil434, I would like to work on this issue under GSSoC.
I have understood the requirement to centralize configuration using pydantic-settings and replace hardcoded values across the codebase.
Please assign this issue to me.

[drishti-1976]

"Hi! I am a GSSoC 2026 contributor. I have strong Python experience and would love to tackle this 'good first issue' to add the pydantic-settings environment loader. Could you please assign it to me?"

[Kokila-chandrakar]

Hi @Devnil434

I would like to work on this issue under GSSoC 2026.

I plan to centralize the configuration using pydantic-settings by creating libs/config/settings.py, replacing hardcoded thresholds in production code with configurable settings, updating .env.example, and adding tests for environment variable overrides in tests/test_settings.py.

I will keep the implementation focused and ensure existing tests remain green.

Please assign this issue to me. Thank you!

[navya-1907]

Hi @Devnil434,

I would like to work on this issue under GSSoC 2026.

I have experience with Python, Docker, Linux, and backend systems, and I would like to contribute to this enhancement. I will keep the implementation focused and ensure that the existing functionality remains stable.

Please assign this issue to me. Thank you!

[Prarthana124]

Hi @Devnil434,
I would like to work on this issue under GSSoC 2026. I understand the requirements and would be happy to contribute.
Please assign me if this issue is still available. Thanks!