# Files SDK

> Unified TypeScript storage abstraction across S3, R2, and 40+ backends

Files SDK is an open-source TypeScript storage layer that standardizes file operations across 48 object and blob storage providers using a single API. It relies on web-standard I/O like Blob and ReadableStream, isolates provider packages into subpath exports to keep bundles small, and includes plugins for encryption, compression, and caching. It also provides ready-to-use tool integrations for AI agent frameworks and a unified CLI.

Website: https://files-sdk.dev/

## What it is for

- Switch between storage providers like AWS S3, Cloudflare R2, and Supabase by changing a single adapter line
- Equip AI agents in the Vercel AI SDK, OpenAI, or Claude frameworks with file storage tools
- Add transparent AES-256 encryption, compression, or deduplication across all read and write pipelines
- Upload files directly from client-side frameworks like React, Vue, or Svelte via prebuilt hooks and components

## Features

- 48 storage adapters including S3, Cloudflare R2, Vercel Blob, Google Cloud Storage, and Azure
- Core API covering 11 uniform methods like upload, download, head, exists, delete, list, and signed URLs
- Modular pipeline plugins for envelope encryption, compression, validation, soft delete, and caching
- Ready-made agent tool integrations for Vercel AI SDK, OpenAI Agents, and Claude
- CLI binary with stdin/stdout streaming and a built-in MCP server
- Typed escape hatch (files.raw) to access the underlying native provider client when needed
- Standardized FilesError class with unified error codes across all adapters

## Pricing

Open source. Free, MIT licensed

## Details

- Type: Web app
- Category: [Development](https://xiry.app/topics/development.md)
- Open source: yes
- Platforms: Code library, Command line, Web
- For: TypeScript and JavaScript developers building applications or AI agents with cloud storage needs
- Alternative to: Flysystem
- Tags: typescript, storage, s3, r2, blob storage, mcp, ai tools

## Why it was saved

- [@haydenbleasel, 11 May 2026](https://x.com/haydenbleasel/status/2053883406459740532): Write-once file storage abstraction that works in Node, Bun, Deno, edge runtimes and browsers, plus ready-made agent tools.

## Related

- [API Anything](https://xiry.app/resources/api-anything): Turn websites into plain HTTP APIs for AI agents to call directly. (GitHub repo, Open source)
- [Better Upload](https://xiry.app/resources/better-upload): Open-source file upload library for React connecting to S3-compatible storage (Web app, Open source)
- [Composio](https://xiry.app/resources/composio): Tooling and authentication layer connecting AI agents to external applications (GitHub repo, Freemium)
- [Prismer Cloud](https://xiry.app/resources/prismer-cloud): Runtime and SDK harness for persistent, evolving AI agent memory (GitHub repo, Open source)
- [Firecrawl](https://xiry.app/resources/firecrawl-1984): Turn websites and documents into clean, LLM-ready markdown or structured data. (Website, Freemium)
- [21st.dev](https://xiry.app/resources/21st-dev): Curated directory of crafted React, Tailwind, and shadcn UI components. (Website, Freemium)

Updated 10 October 2026. Page: https://xiry.app/resources/files-sdk

Make your own library: Xiry takes your saved reels, tweets, Reddit bookmarks and Watch Later videos, makes them searchable and pulls the useful stuff out, like this library. It's invite-only for now; join the waitlist at https://xiry.app/#waitlist.