pynydus.config

Nydus configuration from environment variables only.

LLM (refinement / LLM tiers):

• NYDUS_LLM_TYPE: provider/model (e.g. anthropic/claude-3-5-haiku-20241022)

• NYDUS_LLM_API_KEY: API key for that tier

Both must be set together to enable NydusConfig.llm. If only one is set,

func:

load_config raises ValueError.

Nest registry (push / pull / FROM nydus/...):

• NYDUS_REGISTRY_URL: base URL of the Nest server (e.g. http://localhost:8000)

• NYDUS_REGISTRY_AUTHOR: optional default author for pushes

Module Contents

Classes

RegistryConfig	Nest registry connection settings.
NydusConfig	Top-level Nydus configuration loaded from the environment.

Functions

load_config	Load NydusConfig from NYDUS_* environment variables.
_llm_from_env	Build an LLM tier config from NYDUS_LLM_* env vars, or None if unset.
_registry_from_env	Build a registry config from NYDUS_REGISTRY_* env vars, or None if unset.

API

class pynydus.config.RegistryConfig(/, **data: typing.Any)

Bases: pydantic.BaseModel

Nest registry connection settings.

Initialization

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

url: str

None

Base URL of the Nest server (e.g. http://localhost:8000).

author: str | None

None

Default author name attached to pushes.

class pynydus.config.NydusConfig(/, **data: typing.Any)

Bases: pydantic.BaseModel

Top-level Nydus configuration loaded from the environment.

Initialization

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

llm: pynydus.llm.models.LLMTierConfig | None

None

LLM provider, model, and API key. Required for refinement when set.

registry: pynydus.config.RegistryConfig | None

None

Nest registry connection settings. Required for push/pull when set.

pynydus.config.load_config() → pynydus.config.NydusConfig

Load NydusConfig from NYDUS_* environment variables.

Returns: Validated configuration. Missing LLM or registry env vars yield None for those sections (no error).

Raises: ValueError: If NYDUS_LLM_TYPE and NYDUS_LLM_API_KEY are partially set, or if NYDUS_LLM_TYPE is malformed.

pynydus.config._llm_from_env() → pynydus.llm.models.LLMTierConfig | None

Build an LLM tier config from NYDUS_LLM_* env vars, or None if unset.

Raises: ValueError: If only one of type/key is set, or if the type format is invalid.

pynydus.config._registry_from_env() → pynydus.config.RegistryConfig | None

Build a registry config from NYDUS_REGISTRY_* env vars, or None if unset.