Installation

Prerequisites

• Node.js >= 18.0.0
• DeepSeek API key (obtain one at platform.deepseek.com)

Install Package

npm i deepseek-kit zod dotenv

pnpm i deepseek-kit zod dotenv

bun add deepseek-kit zod dotenv

yarn add deepseek-kit zod dotenv

Configure API Key

Create a .env file in your project root:

DEEPSEEK_API_KEY=your_api_key

The createModel function automatically reads the DEEPSEEK_API_KEY environment variable.

Alternatively, you can pass the API key directly:

import { createModel } from 'deepseek-kit'

const model = createModel({
  model: 'deepseek-v4-flash',
  apiKey: 'your-api-key',
})

Verify Installation

Create a simple script to verify the installation:

import { createModel } from 'deepseek-kit'

const model = createModel({
  model: 'deepseek-v4-flash',
  apiKey: 'your-api-key',
})
const balance = await model.balance()
console.log(balance)

Install Skills

Skills are domain-specific knowledge packages for AI coding assistants. They help your AI assistant better understand deepseek-kit APIs, migration guides, and best practices.

The project includes the following built-in skills:

• deepseek-kit-docs — Documentation writing and management for deepseek-kit
• ai-sdk-migration — Migration guide from Vercel AI SDK to deepseek-kit
• langchainjs-migration — Migration guide from LangChain.js to deepseek-kit

Install deepseek-kit skills to your coding agent using the skills CLI:

npx skills add FliPPeDround/deepseek-kit

pnpm dlx skills add FliPPeDround/deepseek-kit

bun x skills add FliPPeDround/deepseek-kit

yarn dlx skills add FliPPeDround/deepseek-kit