deepseek-ai/3fs

A high-performance distributed file system designed to address the challenges of AI training and inference workloads.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 5 minutes ago
Added to GitGenius on September 6th, 2026
Created on February 27th, 2025
Open Issues & Pull Requests: 161 (+0)
GitHub issues: Enabled
Number of forks: 1,090
Total Stargazers: 10,184 (+0)
Total Subscribers: 95 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 10.1 hours
Mean response time: 14.2 days
90th percentile: 18.0 days
Tracked items: 200

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 100% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Only 9% of issues opened in the past year have been closed.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 125
New in 7 days: 1
Closed in 7 days: 0
Avg open age: 453 days
Stale 30+ days: 121
Stale 90+ days: 114

Recent activity

Opened in 7 days: 1
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

No label distribution available yet.

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

3FS is a distributed file system designed to address the challenges of AI training and inference workloads. It solves the problem of efficiently sharing storage across large-scale AI applications by disaggregating storage across hundreds of nodes equipped with SSDs and RDMA networks. The system implements Chain Replication with Apportioned Queries for strong consistency, allowing applications to access storage in a locality-oblivious manner without learning new APIs—it exposes a standard file interface backed by a transactional key-value store.

The tool is built for organizations running large-scale AI workloads that require high-throughput shared storage for data preparation, training, and inference. It suits projects involving distributed data analytics pipelines, parallel checkpointing for training, random-access dataloaders across compute nodes, and KVCache serving for inference. The disaggregated architecture enables applications to treat thousands of SSDs and hundreds of storage nodes as a unified resource, eliminating the need for data prefetching or shuffling in many scenarios.

Adoption makes sense for teams with infrastructure at scale—the system is demonstrated on clusters with 180 storage nodes and 500+ client nodes, achieving aggregate read throughput in the multi-terabyte-per-second range. It is particularly valuable when you need strong consistency guarantees without sacrificing performance, and when your workload involves managing large volumes of intermediate outputs or serving high-throughput random access patterns. The standard file interface means minimal application code changes compared to custom storage solutions.

The project maintains active development with regular commits across core storage, metadata, and API components. Work spans infrastructure improvements, performance optimization on large clusters, and support for diverse AI workload patterns including data preparation, training checkpointing, and inference serving. The codebase includes comprehensive benchmarking infrastructure and documentation covering design, deployment, and API usage.