# Environment Variables

## Runtime Selection

| Variable | Meaning |
| --- | --- |
| `KEDI_ADAPTER` | Default framework adapter for the Python API/CLI |
| `KEDI_AGENT` | Default harness for the Python API |
| `KEDI_ADAPTER_MODEL` | Default model for the selected backend |
| `MODEL_NAME` | CLI fallback model and codegen fallback |
| `KEDI_PARALLEL` | Enable/size default parallel execution |

`KEDI_ADAPTER` and `KEDI_AGENT` are mutually exclusive. Python `configure()`,
decorator arguments, source directives, and CLI options can provide more local
selection. `KEDI_PARALLEL` accepts `0/1`, `true/false`, `on/off`, or a positive
worker count; invalid values fail rather than silently selecting a mode.

## Code Generation

| Variable | CLI equivalent |
| --- | --- |
| `KEDI_CODEGEN_AGENT` | `--codegen-agent` |
| `KEDI_CODEGEN_MODEL` | `--codegen-model` |
| `KEDI_CODEGEN_RETRIES` | `--codegen-retries` |

`MODEL_NAME` is also consulted by the Pydantic codegen service when no explicit
codegen model is supplied.

## Optimization

| Variable | CLI equivalent |
| --- | --- |
| `KEDI_OPTIMIZER` | `--optimizer` |
| `KEDI_OPTIMIZER_MODEL` | `--optimizer-model` |
| `KEDI_OPTIMIZER_REFLECTION_MODEL` | `--optimizer-reflection-model` |
| `KEDI_OPTIMIZER_MAX_METRIC_CALLS` | `--optimizer-max-metric-calls` |
| `KEDI_OPTIMIZER_MODEL_MAX_TOKENS` | `--optimizer-model-max-tokens` |
| `KEDI_OPTIMIZER_REFLECTION_MODEL_MAX_TOKENS` | `--optimizer-reflection-model-max-tokens` |
| `KEDI_OPTIMIZER_REFLECTION_MINIBATCH_SIZE` | `--optimizer-reflection-minibatch-size` |
| `KEDI_OPTIMIZER_MAX_VALIDATION_EXAMPLES` | `--optimizer-max-validation-examples` |
| `KEDI_DEBUG_OPTIMIZED=1` | Print optimized prompt-loading diagnostics |

The debug variable is for diagnosis and may reveal prompt content; do not leave
it enabled in normal production logs.

## Packages

| Variable | Contract |
| --- | --- |
| `KEDI_HOME` | Absolute Kedi state root; relative paths are rejected |
| `KEDI_REGISTRY_MOCK_ROOT` | Local mock registry root until the public registry exists |

Installed packages live beneath `$KEDI_HOME/registry` or the platform default
Kedi home. Git package operations set `GIT_TERMINAL_PROMPT=0` so unattended
installs fail instead of waiting for credentials.

## Provider Credentials

Provider SDKs read their own variables, such as `GROQ_API_KEY`,
`OPENAI_API_KEY`, `OPENROUTER_API_KEY`, or `ANTHROPIC_API_KEY`. Kedi forwards
selection and settings but does not rename provider credentials. The exact
required variable depends on the model string and adapter.

ACP, Claude, and Codex process settings can also supply an explicit `env`
mapping. It is merged with the current process environment where that adapter
documents process spawning.

## `.env` Loading and Security

The Python API's default configuration loads `.env` through its environment
setup. Explicit arguments and scoped configuration take precedence. Do not
depend on `.env` loading inside a separately spawned harness unless that process
also loads or receives the values.

Never put secrets in `.kedi` source, optimizer datasets, debug exports, or
committed environment files. `MarkdownDebugExporter` does not redact values.
Bundled filesystem tools treat `.env` names as sensitive, but arbitrary Python
code is not intercepted by the approval layer.