Operations

Configure the SDK client

Client configuration is environment-driven. Router, hybrid search, and inference URLs are server-side only.

Client environment

NEOSYNTROPY_API_URL

Base API URL. The SDK normalizes to …/api/v1.

NEOSYNTROPY_API_KEY

nsk_… key with framework:invoke (and telemetry:write for observers).

NEOSYNTROPY_PROJECT_ID

Sent as X-NeoSyntropy-Project-ID for project-scoped telemetry.

NEOSYNTROPY_ACCESS_TOKEN

Alternative to API key for user JWT auth.

.envdotenv

NEOSYNTROPY_API_URL=https://api.neosyntropy.com
NEOSYNTROPY_API_KEY=nsk_...
NEOSYNTROPY_PROJECT_ID=your-project-id

Server-side (not client-facing)

INFERENCE_SERVICE_* and FRAMEWORK_*_MODEL configure the upstream inference container on the backend; FRAMEWORK_SEMANTIC_NODE_HYBRID_* configures hybrid search. Application clients do not set these.

Client vars from BackendClient.from_env(); server vars from neo_syntropy_backend .env.example.