These docs track the main branch and may describe unreleased features. The stable documentation lives at docs.docker.com.

DeepSeek

Use DeepSeek models with docker-agent.

Overview

DeepSeek serves its frontier chat and reasoning models through an OpenAI-compatible API, with strong price/performance on coding and reasoning tasks. docker-agent includes built-in support for DeepSeek as an alias provider.

Setup

  1. Create an API key from the DeepSeek Platform.
  2. Set the environment variable:

    export DEEPSEEK_API_KEY=your-api-key
    

Usage

Inline Syntax

The simplest way to use DeepSeek:

agents:
  root:
    model: deepseek/deepseek-chat
    description: Assistant using DeepSeek
    instruction: You are a helpful assistant.

Named Model

For more control over parameters:

models:
  deepseek_model:
    provider: deepseek
    model: deepseek-chat
    temperature: 0.7
    max_tokens: 8192

agents:
  root:
    model: deepseek_model
    description: Assistant using DeepSeek
    instruction: You are a helpful assistant.

Available Models

DeepSeek exposes a small, vendor-controlled model lineup. Check the DeepSeek models documentation for current model IDs, context limits, and pricing.

Model Description
deepseek-chat DeepSeek-V3, general-purpose chat and tool calling
deepseek-reasoner DeepSeek-R1, extended-reasoning model

Model IDs are case-sensitive and must be passed exactly as the catalogue lists them.

How It Works

DeepSeek is implemented as a built-in alias in docker-agent:

Example: Code Assistant

agents:
  coder:
    model: deepseek/deepseek-chat
    description: Code assistant using DeepSeek-V3
    instruction: |
      You are an expert programmer.
      Write clean, well-documented code and follow language best practices.
    toolsets:
      - type: filesystem
      - type: shell
      - type: think