
files-sdk
A unified storage SDK for object and blob backends. One small, honest API. Web-standards I/O.
The Lens
Files SDK is a TypeScript library that gives you one API across S3, R2, GCS, Azure Blob, Vercel Blob, Dropbox, and the local filesystem. The methods are predictable: upload, download, head, delete, copy, list, url, signedUploadUrl. MIT licensed, web-standards-friendly (Blob, File, ReadableStream, Uint8Array, ArrayBuffer, string).
`npm install files-sdk` plus the adapter you want, like `files-sdk/s3` or `files-sdk/r2`. Each adapter is tree-shakeable so you only ship what you use. There is an escape hatch (`files.raw`) when you need provider-specific behavior. Bundled tool wrappers exist for the Vercel AI SDK, OpenAI Responses, OpenAI Agents, and the Anthropic Claude Agent SDK, which makes it useful for letting agents upload and fetch files.
Solo developers and small teams building products that might switch storage providers should use this. It is the kind of abstraction you wish you had wired in before you shipped six S3-specific code paths across your codebase.
The catch is the project is young and small. Version 1.2 shipped in May 2026, with one primary maintainer (Hayden Bleasel). For internal projects and side work, that is fine. For mission-critical infrastructure where you cannot risk a stalled dependency, vendor it or wait until the project has more contributors.
Get tools like this every Wednesday
One featured tool, three on the radar. No fluff.
Free vs Self-Hosted vs Paid
fully free**Free tier:** Everything. MIT-licensed library, all adapters included.
**Self-hosted:** Not applicable. It is a client SDK you ship inside your own app.
**Paid:** None. You still pay your storage provider directly. AWS S3 is around $0.023/GB/month, Cloudflare R2 is $0.015/GB/month with no egress fees, Vercel Blob is $0.023/GB/month plus ops charges.
MIT licensed. The SDK is free. You still pay your storage provider.
License: MIT License
Use freely, including commercial. Just keep the license.
Commercial use: ✓ Yes
About
- Owner
- Hayden Bleasel (User)
- Stars
- 651
- Forks
- 15
Explore Further
More tools in the directory
langchain
The agent engineering platform
136.7k ★goose
an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
45.2k ★awesome-copilot
Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.
32.9k ★