Skip to content

nexus-fs

Mount S3, GCS, and local storage with two lines of Python.

import nexus.fs

fs = nexus.fs.mount_sync("s3://my-bucket", "local://./data")
content = fs.read("/s3/my-bucket/README.md")

What is nexus-fs?

nexus-fs is a unified filesystem abstraction for cloud storage. You mount backends by URI, and the library exposes them under a single namespace with a consistent API — read, write, ls, stat, delete, rename, copy, mkdir.

It works as a standalone package (~15 dependencies) or as the foundation layer of nexus-ai-fs, which adds versioning, search, permissions, and multi-agent coordination.

Install

pip install nexus-fs            # core (local backend only)
pip install nexus-fs[s3]        # + Amazon S3
pip install nexus-fs[gcs]       # + Google Cloud Storage
pip install nexus-fs[all]       # everything

Next steps

  • Getting Started

    Install nexus-fs and mount your first backend in under 5 minutes.

    Quickstart

  • Backend Guides

    Set up S3, GCS, Google Drive, or local storage.

    Backends

  • Integrations

    Use nexus-fs with pandas, fsspec, LangChain, and more.

    Integrations

  • API Reference

    Auto-generated reference for all public modules.

    Reference