unibox
A unified interface for seamless file operations across local, S3, and Hugging Face ecosystems.
unibox simplifies loading, saving, and exploring data—whether it's a local CSV, an S3-hosted image, or an entire Hugging Face dataset. With a single API, you can handle diverse file types and storage backends effortlessly.
Installation
pip install unibox
Or with uv:
uv tool install unibox
Quick Start
Load anything, anywhere:
import unibox as ub
# Local parquet file
df = ub.loads("data/sample.parquet")
# S3-hosted text file
lines = ub.loads("s3://my-bucket/notes.txt")
# Hugging Face dataset
dataset = ub.loads("hf://user/repo")
Save with ease:
ub.saves(df, "s3://my-bucket/processed.parquet")
ub.saves(dataset, "hf://my-org/new-dataset")
List files or peek at data:
# List all JPGs in an S3 folder
images = ub.ls("s3://bucket/images", exts=[".jpg"])
# Preview a dataset
ub.peeks(dataset)
Why unibox?
- Versatile: Handles CSVs, images, datasets, and more—locally or remotely.
- Simple: One function call to load or save, no matter the source.
- Transformative: From quick data peeks to concurrent downloads, it scales with your needs.
Explore the full power in our documentation.
Contributing
Love unibox? Join us! Check out CONTRIBUTING.md to get started.
Extra dev notes: see README_dev.md.
1 maintainer
Metadata
1 maintainer
Release files for unibox 0.12.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| unibox-0.12.0.tar.gz | 191.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| unibox-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 252.0 kB
Release files / unibox-0.12.0.tar.gz
| Download URL | unibox-0.12.0.tar.gz |
|---|---|
| Size | 191.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3aa28f96ac53a479526e143dd4517e68f1a02cea141070def362e0a64ffdcc2d
|
|
BLAKE2b-256 checksum How to use checksums |
d11cf93dd05f2514f8304e596958dd6387c1d7350c8005b2eb2090b678b55d46
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.16
|
Release files / unibox-0.12.0-py3-none-any.whl
| Download URL | unibox-0.12.0-py3-none-any.whl |
|---|---|
| Size | 60.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3f4b814c345379e85814069633e4dab2e823daa0a7c1f42e368b60cd4644cd9a
|
|
BLAKE2b-256 checksum How to use checksums |
d3721152f87f5698def9c9acd082497526921e942b9ef090ae6dce4b386b4488
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.16
|
