Mipham Code

1. Set Environment Variable

Example with DeepSeek (add to ~/.zshrc for persistence):

export DEEPSEEK_API_KEY="sk-your-key"

2. Config File ~/.mipham/config.yml

Optional — mipham runs on built-in defaults, and the setup wizard writes this file for you. Write it by hand to pin a default or override a provider. 5 of the 12 built-in providers shown, plus one custom provider:

# Default model (used at startup)
defaultProvider: deepseek
defaultModel: deepseek-v4-pro

providers:
  # Built-in providers: `id` + `apiKey` is all you need. The extra fields
  # below are optional overrides. Omit `models:` to keep every built-in
  # model — listing models here replaces the built-in list wholesale.
  - id: deepseek
    name: DeepSeek
    protocol: openai-compatible
    baseUrl: https://api.deepseek.com/v1
    apiKey: ${DEEPSEEK_API_KEY}

  - id: doubao
    name: Doubao (ByteDance)
    protocol: openai-compatible
    baseUrl: https://ark.cn-beijing.volces.com/api/v3
    apiKey: ${DOUBAO_API_KEY}

  - id: qwen
    name: Qwen (Alibaba)
    protocol: openai-compatible
    baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1
    apiKey: ${QWEN_API_KEY}

  - id: anthropic
    name: Anthropic Claude
    protocol: anthropic
    apiKey: ${ANTHROPIC_API_KEY}

  - id: openai
    name: OpenAI
    protocol: openai-compatible
    baseUrl: https://api.openai.com/v1
    apiKey: ${OPENAI_API_KEY}

  # Custom provider (not built in): declare your own models. Every field
  # under a model is required.
  - id: my-gateway
    name: My Gateway
    protocol: openai-compatible
    baseUrl: https://gateway.example.com/v1
    apiKey: ${MY_GATEWAY_API_KEY}
    models:
      - id: my-model-pro
        name: My Model Pro
        providerId: my-gateway
        contextWindow: 200000
        maxOutput: 64000
        vision: true
        status: active

apiKey supports ${ENV_VAR} (recommended) or plain key string.

3. Launch

mipham

Press Ctrl+P to switch providers and models anytime.