/ README.md
README.md
 1  # AI SDK Tools
 2  
 3  ![AI SDK Tools](image.png)
 4  
 5  > **⚠️ Active Development Notice**
 6  > 
 7  > This package is currently in **active development** and breaking changes may occur between versions. We recommend pinning to specific versions in production environments and staying updated with our changelog.
 8  
 9  Essential utilities for building production-ready AI applications with Vercel AI SDK. State management, debugging, structured streaming, intelligent agents, caching, and persistent memory.
10  
11  ## Installation
12  
13  ### Unified Package (Recommended)
14  
15  Install everything in one package:
16  
17  ```bash
18  npm install ai-sdk-tools
19  ```
20  
21  Import what you need:
22  
23  ```typescript
24  // Server-side
25  import { Agent, artifact, cached } from 'ai-sdk-tools';
26  
27  // Client-side
28  import { useChat, useArtifact, AIDevtools } from 'ai-sdk-tools/client';
29  ```
30  
31  ### Individual Packages
32  
33  Or install only what you need:
34  
35  ### [@ai-sdk-tools/store](./packages/store)
36  AI chat state management that eliminates prop drilling. Clean architecture and better performance for chat components.
37  
38  ```bash
39  npm i @ai-sdk-tools/store
40  ```
41  
42  ### [@ai-sdk-tools/devtools](./packages/devtools)
43  Development tools for debugging AI applications. Inspect tool calls, messages, and execution flow directly in your app.
44  
45  ```bash
46  npm i @ai-sdk-tools/devtools
47  ```
48  
49  ### [@ai-sdk-tools/artifacts](./packages/artifacts)
50  Stream structured, type-safe artifacts from AI tools to React components. Build dashboards, analytics, and interactive experiences beyond chat.
51  
52  ```bash
53  npm i @ai-sdk-tools/artifacts @ai-sdk-tools/store
54  ```
55  
56  ### [@ai-sdk-tools/agents](./packages/agents)
57  Multi-agent orchestration with automatic handoffs and routing. Build intelligent workflows with specialized agents for any AI provider.
58  
59  ```bash
60  npm i @ai-sdk-tools/agents ai zod
61  ```
62  
63  ### [@ai-sdk-tools/cache](./packages/cache)
64  Universal caching for AI SDK tools. Cache expensive operations with zero configuration - works with regular tools, streaming, and artifacts.
65  
66  ```bash
67  npm i @ai-sdk-tools/cache
68  ```
69  
70  ### [@ai-sdk-tools/memory](./packages/memory)
71  Persistent memory system for AI agents. Add long-term memory with support for multiple storage backends (In-Memory, Upstash Redis, Drizzle).
72  
73  ```bash
74  npm i @ai-sdk-tools/memory
75  ```
76  
77  ## Getting Started
78  
79  Visit our [website](https://ai-sdk-tools.dev) to explore interactive demos and detailed documentation for each package.
80  
81  ## Used by
82  
83  <a href="https://midday.ai">
84    <img src="https://pbs.twimg.com/profile_images/1930607581971501057/vz4YyNOV_400x400.png" alt="Midday" width="48" height="48" style="vertical-align:middle; border-radius:8px;" />
85  </a>
86  
87  ## License
88  
89  MIT