LLM Configuration

The [llm] section configures LLM provider credentials and custom provider endpoints. You can use built-in providers or define custom ones.

Built-in Provider Keys

Spacebot supports multiple LLM providers. Configure credentials for the providers you want to use.

anthropic_key

string

Anthropic API key. Supports env:VAR_NAME references.

anthropic_key = "env:ANTHROPIC_API_KEY"

openai_key

string

OpenAI API key. Supports env:VAR_NAME references.

openai_key = "env:OPENAI_API_KEY"

openrouter_key

string

OpenRouter API key. Supports env:VAR_NAME references.

openrouter_key = "env:OPENROUTER_API_KEY"

kilo_key

string

Kilo Gateway API key. Supports env:VAR_NAME references.

kilo_key = "env:KILO_API_KEY"

gemini_key

string

Google Gemini API key. Supports env:VAR_NAME references.

gemini_key = "env:GEMINI_API_KEY"

groq_key

string

Groq API key. Supports env:VAR_NAME references.

groq_key = "env:GROQ_API_KEY"

deepseek_key

string

DeepSeek API key. Supports env:VAR_NAME references.

deepseek_key = "env:DEEPSEEK_API_KEY"

xai_key

string

xAI (Grok) API key. Supports env:VAR_NAME references.

xai_key = "env:XAI_API_KEY"

mistral_key

string

Mistral AI API key. Supports env:VAR_NAME references.

mistral_key = "env:MISTRAL_API_KEY"

together_key

string

Together AI API key. Supports env:VAR_NAME references.

together_key = "env:TOGETHER_API_KEY"

fireworks_key

string

Fireworks AI API key. Supports env:VAR_NAME references.

fireworks_key = "env:FIREWORKS_API_KEY"

nvidia_key

string

NVIDIA NIM API key. Supports env:VAR_NAME references.

nvidia_key = "env:NVIDIA_API_KEY"

zhipu_key

string

Z.AI (GLM) API key. Supports env:VAR_NAME references.

zhipu_key = "env:ZHIPU_API_KEY"

minimax_key

string

MiniMax API key (international endpoint). Supports env:VAR_NAME references.

minimax_key = "env:MINIMAX_API_KEY"

minimax_cn_key

string

MiniMax API key (China endpoint). Supports env:VAR_NAME references.

minimax_cn_key = "env:MINIMAX_CN_API_KEY"

moonshot_key

string

Moonshot AI API key. Supports env:VAR_NAME references.

moonshot_key = "env:MOONSHOT_API_KEY"

zai_coding_plan_key

string

Z.AI Coding Plan API key. Supports env:VAR_NAME references.

zai_coding_plan_key = "env:ZAI_CODING_PLAN_KEY"

opencode_zen_key

string

OpenCode Zen API key. Supports env:VAR_NAME references.

opencode_zen_key = "env:OPENCODE_ZEN_KEY"

opencode_go_key

string

OpenCode Go API key. Supports env:VAR_NAME references.

opencode_go_key = "env:OPENCODE_GO_KEY"

ollama_base_url

string

Ollama server base URL. Defaults to http://localhost:11434.

ollama_base_url = "http://localhost:11434"

ollama_key

string

Optional Ollama API key (rarely needed for local deployments).

ollama_key = "env:OLLAMA_KEY"

Custom Providers

Define custom provider endpoints to use models from any OpenAI-compatible or Anthropic-compatible API.

provider.<name>

object

Custom provider configuration. Replace <name> with your provider identifier.

Show Properties

api_type

string

required

API compatibility type. Must be one of:

openai_completions - OpenAI Chat Completions API (/v1/chat/completions)
openai_chat_completions - OpenAI-compatible API (/chat/completions)
anthropic - Anthropic Messages API (/v1/messages)
gemini - Google Gemini API
kilo_gateway - Kilo Gateway API with required headers
openai_responses - OpenAI Responses API (/v1/responses)

base_url

string

required

Base URL for the provider API endpoint.

api_key

string

required

API key for authentication. Supports env:VAR_NAME references.

name

string

Optional display name for the provider.

Examples

Using Built-in Providers

[llm]
anthropic_key = "env:ANTHROPIC_API_KEY"
openai_key = "env:OPENAI_API_KEY"
openrouter_key = "env:OPENROUTER_API_KEY"

Custom Provider with OpenAI API

[llm.provider.my_openai_proxy]
api_type = "openai_completions"
base_url = "https://my-proxy.example.com/v1"
api_key = "env:MY_PROXY_KEY"
name = "My OpenAI Proxy"

Custom Provider with Anthropic API

[llm.provider.my_anthropic_proxy]
api_type = "anthropic"
base_url = "https://my-proxy.example.com"
api_key = "env:MY_ANTHROPIC_PROXY_KEY"
name = "My Anthropic Proxy"

Local Ollama Instance

[llm]
ollama_base_url = "http://localhost:11434"

Multiple Providers

[llm]
anthropic_key = "env:ANTHROPIC_API_KEY"
openrouter_key = "env:OPENROUTER_API_KEY"
groq_key = "env:GROQ_API_KEY"
ollama_base_url = "http://localhost:11434"

[llm.provider.custom_endpoint]
api_type = "openai_completions"
base_url = "https://api.example.com/v1"
api_key = "env:CUSTOM_API_KEY"

Environment Variable References

All credential fields support env:VAR_NAME references to read values from environment variables:

[llm]
anthropic_key = "env:ANTHROPIC_API_KEY"  # Reads from $ANTHROPIC_API_KEY
openai_key = "env:OPENAI_API_KEY"        # Reads from $OPENAI_API_KEY

This keeps sensitive credentials out of your config file.

CLI Commands

Configuration

Tools

LLM Configuration

Built-in Provider Keys

Custom Providers

Examples

Using Built-in Providers

Custom Provider with OpenAI API

Custom Provider with Anthropic API

Local Ollama Instance

Multiple Providers

Environment Variable References

Build docs developers (and LLMs) love

CLI Commands

Configuration

Tools

​Built-in Provider Keys

​Custom Providers

​Examples

​Using Built-in Providers

​Custom Provider with OpenAI API

​Custom Provider with Anthropic API

​Local Ollama Instance

​Multiple Providers

​Environment Variable References

Build docs developers (and LLMs) love

Built-in Provider Keys

Custom Providers

Examples

Using Built-in Providers

Custom Provider with OpenAI API

Custom Provider with Anthropic API

Local Ollama Instance

Multiple Providers

Environment Variable References