Filebin.net Python Client

A complete, typed, async-first Python client and CLI for the Filebin.net API.

Note: This is an unofficial, community-driven Python wrapper for Filebin, not affiliated with the official filebin.net service.

Installation

pip install filebin

With CLI formatting support:

pip install filebin[cli-pretty]

Quick Client Usage

import asyncio
from filebin import AsyncFilebinClient

async def main():
    async with AsyncFilebinClient() as client:
        # Upload a file
        file = await client.upload_file("my-bin-id", "document.pdf")
        print(f"Uploaded: {file.filename}")

        # List files in a bin
        bin_meta = await client.list_bin("my-bin-id")
        for f in bin_meta.files:
            print(f.filename)

if __name__ == "__main__":
    asyncio.run(main())

Quick CLI Usage

# Upload a file
fbin upload document.pdf --bin my-bin-id

# Download a file
fbin download my-bin-id document.pdf

# List contents
fbin list my-bin-id

Documentation

Full documentation is available at: https://aaron-fredrick.github.io/filebin/