📋 Prerequisites
🎯 Affected Service(s)
Not Sure
🚦 Impact/Severity
Minor inconvenience
🐛 Bug Description
The kagent install CLI currently enforces the presence of OPENAI_API_KEY, even when the user intends to use a non-OpenAI provider (e.g. Ollama, local models, or other supported providers).
This creates a misleading and blocking setup experience for users who are not using OpenAI at all.
According to the quickstart documentation, an OpenAI API key is required as part of the setup flow, but this requirement is not universally valid, since kagent supports multiple providers and OpenAI is optional.
🔄 Steps To Reproduce
kagent install --profile minimal
Without setting:
export OPENAI_API_KEY=...
🤔 Expected Behavior
The CLI exits with:
OPENAI_API_KEY is not set
Please set the OPENAI_API_KEY environment variable
This blocks installation entirely.
📱 Actual Behavior
Installation should succeed without requiring OPENAI_API_KEY when:
- user is not configuring OpenAI
- user intends to use another provider (e.g. Ollama)
- or no model is configured at install time
💻 Environment
- kagent CLI version: (0.8.4)
- Kubernetes: Kind (local)
- Provider: Ollama (in-cluster)
🔧 CLI Bug Report
Workaround
Users can bypass this by setting a dummy value:
export OPENAI_API_KEY=dummy
However, this is unintuitive and not documented.
🔍 Additional Context
The installer currently assumes OpenAI as a mandatory dependency, which contradicts the multi-provider design of kagent. This should be relaxed to support non-OpenAI workflows cleanly.
📋 Logs
📷 Screenshots
No response
🙋 Are you willing to contribute?
📋 Prerequisites
🎯 Affected Service(s)
Not Sure
🚦 Impact/Severity
Minor inconvenience
🐛 Bug Description
The
kagent installCLI currently enforces the presence ofOPENAI_API_KEY, even when the user intends to use a non-OpenAI provider (e.g. Ollama, local models, or other supported providers).This creates a misleading and blocking setup experience for users who are not using OpenAI at all.
According to the quickstart documentation, an OpenAI API key is required as part of the setup flow, but this requirement is not universally valid, since kagent supports multiple providers and OpenAI is optional.
🔄 Steps To Reproduce
kagent install --profile minimal
Without setting:
export OPENAI_API_KEY=...
🤔 Expected Behavior
The CLI exits with:
OPENAI_API_KEY is not set
Please set the OPENAI_API_KEY environment variable
This blocks installation entirely.
📱 Actual Behavior
Installation should succeed without requiring OPENAI_API_KEY when:
💻 Environment
🔧 CLI Bug Report
Workaround
Users can bypass this by setting a dummy value:
export OPENAI_API_KEY=dummy
However, this is unintuitive and not documented.
🔍 Additional Context
The installer currently assumes OpenAI as a mandatory dependency, which contradicts the multi-provider design of kagent. This should be relaxed to support non-OpenAI workflows cleanly.
📋 Logs
📷 Screenshots
No response
🙋 Are you willing to contribute?