---
id: ocifs
version: "1.3.4"
license: unclear
license_treatment: unclear
maintenance: aging
---

# ocifs — Convenient filesystem interface over Oracle Cloud's Object Storage

License: unclear · Maintenance: aging · Downloads: 203.1K/mo

## What it is and what it does

ocifs is a Python package that implements the fsspec (filesystem_spec) interface for Oracle Cloud Infrastructure Object Storage. It allows you to interact with OCI buckets using standard filesystem operations—read, write, list, delete, rename—through a unified API that looks and behaves like a local filesystem. This makes it possible to use OCI Object Storage seamlessly with data libraries like Pandas, Dask, and PyArrow without writing cloud-specific code.

The package depends on fsspec (the base interface), oci (Oracle's Python SDK), and requests (HTTP client). It supports Python 3.6 and later, including current versions up to 3.14. Authentication is handled via OCI configuration files or environment variables, supporting both API key and resource principal signers. The package is maintained by Oracle and has been in production use since 2021.

Use it for:

- Read CSV or Parquet files directly from OCI Object Storage into Pandas DataFrames using standard read_csv/read_parquet calls with storage_options.
- Build data pipelines with Dask that operate on objects stored in OCI buckets without downloading them locally first.
- Perform file operations (upload, download, list, delete) on OCI Object Storage from Python scripts using familiar filesystem methods.
- Integrate OCI Object Storage as a backend for machine learning workflows that expect a fsspec-compatible storage layer.
- Migrate workloads from other cloud object stores (S3, GCS) to OCI by swapping the fsspec backend without changing application logic.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a fsspec-compatible filesystem interface to Oracle Cloud Infrastructure Object Storage, enabling file-like operations on OCI buckets through a standard API.

Yes, if you are working with OCI Object Storage and want to integrate it with Pandas, Dask, or other fsspec-aware libraries. The package is production-stable and has no known vulnerabilities. The main caveat is aging maintenance—281 days since last release—so verify that the version supports your OCI SDK and Python versions. License treatment is marked unclear in metadata; confirm UPL terms align with your project before committing.

## Install

pip install ocifs
uv add ocifs
poetry add ocifs

## Installing ocifs

Before you install: Low friction install with three straightforward runtime dependencies. Maintenance status is aging—last release was 281 days ago—but the repository remains active and the package is marked Production/Stable.

License in practice: License treatment is unclear in the metadata, though the description states Universal Permissive License v1.0 (UPL). Verify the actual license terms before use if compliance is a concern.

Quickstart:

from ocifs import OCIFileSystem

fs = OCIFileSystem("~/.oci/config")
fs.touch("oci://<bucket>@<namespace>/<prefix>/file.txt", data=b"content")
data = fs.cat("oci://<bucket>@<namespace>/<prefix>/file.txt")

Requires OCI credentials configured at ~/.oci/config or via environment variables (OCIFS_IAM_TYPE, OCIFS_CONFIG_LOCATION, OCIFS_CONFIG_PROFILE).

Verify before relying:

- Whether license_treatment 'unclear' reflects a genuine metadata gap or a known UPL classification issue.
- Performance characteristics and throughput limits for large-scale or high-concurrency workloads.
- Compatibility guarantees with specific versions of fsspec, Pandas, Dask, or PyArrow beyond the examples shown.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 203.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

oracle cloud object storage filesystem, oci fsspec implementation, cloud storage file interface, oracle cloud integration python, object storage abstraction layer, oci bucket access library, fsspec oci backend, cloud-storage, oracle-cloud, fsspec-backend

[View on SkillFed](https://skillfed.io/packages/ocifs) · [View on PyPI](https://pypi.org/project/ocifs/)