# Vercel Blob
> Upload, download, list, copy, and delete files in cloud storage. Give your AI agents the ability to persist and manage files with public URLs.

- **Package:** vercel-blob-ai-sdk
- **Author:** Flash Brew Digital
- **Tags:** storage, files, blob, upload

## Environment Variables
- `BLOB_READ_WRITE_TOKEN`

## Included Tools
- **uploadAsset:** Upload files, images, or text content to cloud storage
- **listAssets:** List stored assets with optional filtering by prefix
- **getAssetInfo:** Get metadata about an asset without downloading
- **downloadAsset:** Download and retrieve the contents of an asset
- **copyAsset:** Copy an asset to a new location
- **deleteAsset:** Delete a single asset
- **deleteAssets:** Delete multiple assets at once

## Installation
```bash
npm install vercel-blob-ai-sdk
```

## Usage
```typescript
import { generateText, stepCountIs } from 'ai';
import { uploadAsset, listAssets, downloadAsset } from 'vercel-blob-ai-sdk';

const { text } = await generateText({
  model: 'openai/gpt-4o',
  prompt: 'Save a file called hello.txt with the content "Hello, world!"',
  tools: {
    uploadAsset,
    listAssets,
    downloadAsset,
  },
  stopWhen: stepCountIs(3),
});

console.log(text);
```

## Links
- [Documentation](https://github.com/Flash-Brew-Digital/vercel-blob-ai-sdk)
- [npm](https://www.npmjs.com/package/vercel-blob-ai-sdk)
- [GitHub](https://github.com/Flash-Brew-Digital/vercel-blob-ai-sdk)

---
[Full Library Index](/library.md)