Docs menu

Environment

AGENKO_API_KEY, AGENKO_HOST, and friends.

init() reads env. Do not pass a config object unless you are writing tests.

SDK

VariableDefaultPurpose
AGENKO_API_KEYemptyProject key. Required to ingest and connect.
AGENKO_HOSThttp://localhost:8000Control plane base URL.
AGENKO_HTTP_ENDPOINT—Legacy alias of AGENKO_HOST.
AGENKO_ENDPOINT{host}/api/public/otel/v1/tracesOTLP/HTTP traces.
AGENKO_SERVICE_NAMEagenko-agentservice.name on spans.
AGENKO_ENVdevelopmentEnvironment tag.
AGENKO_PROJECT_ID—Scope for prompts, scores, and datasets.
AGENKO_SESSION_IDrandomsession.id on every span (Langfuse filter).
AGENKO_USER_ID—user.id on every span (Langfuse filter).
AGENKO_CONSOLE_URLhttp://localhost:3000Printed after init; approval links.
AGENKO_DEBUGunsetSet 1 for verbose SDK logs.

After make dev, copy the agk_dev_* key from API logs into AGENKO_API_KEY.

Local compose (server)

See .env.example in the monorepo: DATABASE_URL, REDIS_URL, SECRET_KEY, MinIO, optional SuperTokens, optional Resend, optional Slack.

Do not put OAuth secrets in the root .env if the console loads agenko-frontend/.env.local — empty values override.

Honesty

Empty AGENKO_API_KEY is valid. The process runs; traces do not land in a project until a key exists.

Agent instructions

This page is part of the Agenko documentation at docs.agenko.app. Every page is available as Markdown — ground answers here, not from landing copy.

Querying these docs

Before writing SDK code

  • Install the agent skill or read Agent skill
  • Read Best practices — what a good receipt looks like
  • Trust boundary: @check after, @approve before
  • init() — zero required args, never throws
  • Mark estimated: true until a check is a hard fact
  • Shipped vs backlog: Introduction status table

Page: Environment
HTML: https://docs.agenko.app/environment
Markdown: https://docs.agenko.app/environment.md