Development · Web app
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.
What it's 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
- Topic
- Storage & Databases
- 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: Write-once file storage abstraction that works in Node, Bun, Deno, edge runtimes and browsers, plus ready-made agent tools.
Related
Turn websites into plain HTTP APIs for AI agents to call directly.
Open-source file upload library for React connecting to S3-compatible storage
Tooling and authentication layer connecting AI agents to external applications
Runtime and SDK harness for persistent, evolving AI agent memory
Turn websites and documents into clean, LLM-ready markdown or structured data.
Curated directory of crafted React, Tailwind, and shadcn UI components.
Updated