Configuration Reference

@dataclass
class Config:
    # S3 gateway settings
    host: str = "0.0.0.0"
    port: int = 9000
    region: str = "us-east-1"

    # FTP gateway settings
    ftp_host: str = "0.0.0.0"
    ftp_port: int = 2121
    ftp_user: str = field(default_factory=lambda: os.environ.get("FTP_USERNAME", ""))
    ftp_password: str = field(
        default_factory=lambda: os.environ.get("FTP_PASSWORD", "")
    )
    # HF Hub settings
    hf_endpoint: str = "https://huggingface.co"
    hf_token: str = field(default_factory=lambda: os.environ.get("HF_TOKEN", ""))

    # S3 auth — maps to HF token
    s3_access_key: str = field(
        default_factory=lambda: os.environ.get("AWS_ACCESS_KEY_ID", "")
    )
    s3_secret_key: str = field(
        default_factory=lambda: os.environ.get("AWS_SECRET_ACCESS_KEY", "")
    )

    # HF namespace (user or org that owns the buckets)
    # Resolved automatically from HF token via /api/whoami-v2 at startup
    hf_namespace: str = ""

    # Xet CDC settings
    xet_chunk_target: int = 65536   # 64 KiB
    xet_chunk_min: int = 8192       # 8 KiB
    xet_chunk_max: int = 131072     # 128 KiB
    xet_xorb_max_bytes: int = 67108864  # 64 MiB

    # Concurrency / connection-pool settings
    http_pool_size: int = 0  # 0 = unlimited

    # Upload settings
    cas_upload_timeout: int = 300       # 5 minutes per CAS request
    cas_upload_retries: int = 3         # retry count for CAS xorb/shard uploads
    cas_retry_base_delay: float = 1.0   # base delay (seconds) for exponential backoff
    multipart_upload_ttl: int = 86400   # 24 hours before stale multipart cleanup

    # Cache settings
    xorb_cache_max_bytes: int = 512 * 1024 * 1024  # 512 MiB
    recon_cache_max_entries: int = 1024
    recon_cache_ttl: int = 300          # 5 minutes
    file_info_cache_max_entries: int = 256
    file_info_cache_ttl: int = 30       # 30 seconds