Environment
AGENKO_API_KEY, AGENKO_HOST, and friends.
init() reads env. Do not pass a config object unless you are writing tests.
SDK
| Variable | Default | Purpose |
|---|---|---|
AGENKO_API_KEY | empty | Project key. Required to ingest and connect. |
AGENKO_HOST | http://localhost:8000 | Control plane base URL. |
AGENKO_HTTP_ENDPOINT | — | Legacy alias of AGENKO_HOST. |
AGENKO_ENDPOINT | {host}/api/public/otel/v1/traces | OTLP/HTTP traces. |
AGENKO_SERVICE_NAME | agenko-agent | service.name on spans. |
AGENKO_ENV | development | Environment tag. |
AGENKO_PROJECT_ID | — | Scope for prompts, scores, and datasets. |
AGENKO_SESSION_ID | random | session.id on every span (Langfuse filter). |
AGENKO_USER_ID | — | user.id on every span (Langfuse filter). |
AGENKO_CONSOLE_URL | http://localhost:3000 | Printed after init; approval links. |
AGENKO_DEBUG | unset | Set 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
- Full index: docs.agenko.app/llms.txt · sections: llms-docs.txt, llms-sdk.txt, llms-integrations.txt
- This page as markdown: docs.agenko.app/environment.md
- Search API:
curl -sG "https://docs.agenko.app/api/search-docs" --data-urlencode "query=…"
Before writing SDK code
- Install the agent skill or read Agent skill
- Read Best practices — what a good receipt looks like
- Trust boundary:
@checkafter,@approvebefore init()— zero required args, never throws- Mark
estimated: trueuntil a check is a hard fact - Shipped vs backlog: Introduction status table