Skip to main content

Environment Variables

Reference for environment variables used by the Sekuire TypeScript SDK.

Core Runtime & Identity​

VariableDescription
SEKUIRE_AGENT_IDAgent Sekuire ID (required for SekuireSDK.fromEnv())
SEKUIRE_AGENT_NAMEOptional display name
SEKUIRE_PRIVATE_KEYOptional private key for identity signing utilities
SEKUIRE_PUBLIC_KEYOptional public key for verification utilities

Bootstrap & Credential Recovery​

VariableDescription
SEKUIRE_INSTALL_TOKENOne-time bootstrap token
SEKUIRE_INSTALLATION_IDInstallation ID for recovery
SEKUIRE_REFRESH_TOKENRefresh token for runtime token rotation
SEKUIRE_RUNTIME_TOKENExisting runtime token (optional)

Auth resolution by component​

  • Beacon: recovery credentials first (INSTALLATION_ID + REFRESH_TOKEN), validates existing runtime token when present, then install token.
  • TaskWorker: runtime token first, then recovery credentials, then install token.
  • A2AClient task endpoints: tokenResolver runtime token, else setRuntimeToken, else JWT bearer if token looks JWT-like, else API key headers. Runtime-token 401 responses can auto-refresh once via onUnauthorized.

API/Workspace Settings​

VariableDescriptionDefault
SEKUIRE_API_URLCore API base URLhttps://api.sekuire.ai
SEKUIRE_WORKSPACE_IDWorkspace for policy + recovery bootstrap-
SEKUIRE_API_KEYAPI key for registry/core endpoints-
SEKUIRE_ENVIRONMENTEnvironment labelproduction
SEKUIRE_DEPLOYMENT_URLOptional explicit deployment URLauto-detected
SEKUIRE_DEVICE_FINGERPRINTOptional device fingerprint for API-key auth on A2A task endpointssekuire-typescript-sdk

Policy/Override Settings​

VariableDescription
SEKUIRE_POLICY_DEV_OVERRIDEWarn-only policy enforcement mode when true
SEKUIRE_NO_CTASuppress standalone-mode upgrade message when true
SEKUIRE_TELEMETRYOpt-in to anonymous usage telemetry when true (default off)

LLM Provider Keys​

VariableDescription
OPENAI_API_KEYOpenAI API key
ANTHROPIC_API_KEYAnthropic API key
GOOGLE_API_KEYGoogle API key
OLLAMA_BASE_URLOllama endpoint (http://localhost:11434 default)

Example .env​

SEKUIRE_AGENT_ID=7f8a9b3c2d1e...
SEKUIRE_AGENT_NAME=my-agent
SEKUIRE_API_URL=https://api.sekuire.ai
SEKUIRE_WORKSPACE_ID=ws_abc123

# Initial bootstrap
SEKUIRE_INSTALL_TOKEN=skt_xxx

# Recovery (preferred after first deploy)
SEKUIRE_INSTALLATION_ID=inst_xxx
SEKUIRE_REFRESH_TOKEN=srf_xxx
SEKUIRE_RUNTIME_TOKEN=srt_xxx

SEKUIRE_API_KEY=sk_live_xxx
OPENAI_API_KEY=sk-...

Next Steps​