---
title: "@cmtx/ai"
lang: en
skip_doc_render: true
---

# @cmtx/ai

[![npm version](https://img.shields.io/npm/v/@cmtx/ai.svg)](https://www.npmjs.com/package/@cmtx/ai)
[![License](https://img.shields.io/npm/l/@cmtx/ai.svg)](https://github.com/cc01cc/cmtx-project/blob/main/LICENSE)

CMTX AI capability package — Slug generation, content validation, Agent orchestration (integrates Vercel AI SDK).

> Full API documentation: `pnpm run docs` (generated in `docs/api/`)

## Installation

```bash
pnpm add @cmtx/ai
```

AI Provider is an optional dependency; install as needed:

```bash
# DeepSeek
pnpm add @ai-sdk/deepseek

# Alibaba Qwen
pnpm add @ai-sdk/alibaba

# OpenAI-compatible interfaces (DeepSeek/Qwen/local models, etc.)
pnpm add @ai-sdk/openai-compatible
```

## Slug Generation

```typescript
import { generateSlug } from "@cmtx/ai";

const slug = await generateSlug(
    {
        provider: "deepseek",
        model: "deepseek-v4-flash",
        apiKey: process.env.CMTX_DEEPSEEK_API_KEY,
    },
    "深入理解 TypeScript 类型系统",
);
// => "shen-ru-li-jie-typescript-lei-xing-xi-tong"
```

## Dependency Hierarchy

```
foundation (@cmtx/core)
    ↓
@cmtx/ai (AI capabilities)
    ↓
@cmtx/rule-engine (rule engine, integrates AI rules)
    ↓
Application layer (cli, vscode)
```