# Terry-Mao/bfs

distributed file system(small file storage) writen in golang.

Repository: https://github.com/Terry-Mao/bfs
Canonical: https://ross.abutalabs.com/products/terry-mao-bfs
Language: Go
License Family: other
Last push: 2021-02-24T09:23:52+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3973, "days_push": 2016, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1592, forks 305 (observed 2026-08-28T04:05:08.812589+00:00)

## What it is
BFS is a distributed file system for small-file storage written in Go, modeled after Facebook's Haystack architecture. It consists of directory, store, pitchfork, proxy, and ops components, using HBase for metadata and ZooKeeper for coordination.

## Use cases
- store billions of small files like images at high throughput
- self-host a Haystack-style distributed file store
- serve user-uploaded images with low latency
- manage object storage clusters with metadata in HBase
- monitor storage node health and disk status

## When to choose
- you need high-throughput, low-latency storage for many small files
- you want a self-hosted Haystack-like design in Go
- you already run HBase and ZooKeeper infrastructure

## When to avoid
- you need general-purpose POSIX file system semantics
- you want a maintained project with active development and a license
- you need large-file or block storage
- you want a turnkey solution without HBase/ZooKeeper dependencies

## Facets
- artifact type: service
- maturity: maintenance
- function: file-system, http-server, monitoring, proxy
- domain: microservices, infrastructure-as-code, self-hosted, files
- platform: go, self-hosted
- tags: distributed-file-system, small-file-storage, facebook-haystack, hbase, zookeeper, object-storage, linux

## Member repositories
- Terry-Mao/bfs (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:08.812589+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:54:16.776709+00:00, confidence not recorded.
  - readme: https://github.com/Terry-Mao/bfs (fetched 2026-08-28T04:05:08.812589+00:00, sha 0c7b8f8274eb)
- Data as of 2026-08-30T08:39:29.467469+00:00.