Skip to content

⚡ B-FAST (Binary Fast Adaptive Serialization Transfer)

CI Documentation PyPI version Python versions npm version License: MIT Performance CodSpeed

B-FAST is an ultra-high performance binary serialization protocol, developed in Rust for Python and TypeScript ecosystems. It's designed to replace JSON in critical routes where latency, CPU usage, and bandwidth are bottlenecks.

"Performance is not just about speed—it's about efficiency where it matters most"

B-FAST was born from the recognition that modern applications need more than just fast serialization—they need smart serialization that adapts to real-world constraints. After extensive optimization, B-FAST has found its perfect niche in bandwidth-constrained environments, achieving 1.7x faster than orjson for simple objects and 5.7x faster on slow networks.

Philosophy: We believe that the future of data transfer lies not in raw CPU speed alone, but in intelligent protocols that minimize network overhead while maintaining excellent performance. B-FAST represents our contribution to a more efficient, bandwidth-conscious web.

🚀 Features & Architecture

  • ⚡ Extreme Performance

    2.01 ms for 10k objects (4.1x faster than orjson, 6.0x vs JSON). Up to 24x faster primitive serialization via Rust fast-paths.

    View Benchmarks

  • 🌊 Real-Time Streaming & MCP

    Continuous binary streaming (application/x-bfast-stream), chunked HTTP transfer, and Model Context Protocol (MCP) tool results.

    FastMCP & Streaming Guide

  • 🐍 Python APIs & Data Science

    Drop-in integrations for FastAPI, Django Ninja, Polars, and Pandas with native DataFrame serialization.

    Integrations Guide

  • 💻 Modern TypeScript & TanStack Query

    Zero-config client for browsers and Node.js with TanStack Query options, Zod / Standard Schema validation, and Wasm LZ4.

    Frontend Guide

  • 🤖 AI & LLMs (llms.txt)

    Standardized documentation endpoint for OpenCode, Cursor, Claude Code, and Copilot with zero hallucination.

    AI & LLM Guide

  • 📚 Complete API Reference

    Complete reference for all classes, methods, parameters, and helper utilities in Python and TypeScript.

    API Reference

📊 Performance

🚀 Simple Objects (10,000)

Format Time (ms) Speedup
JSON 12.0ms 1.0x
orjson 8.19ms 1.5x
B-FAST 2.01ms 🚀 6.0x

B-FAST is 4.1x faster than orjson!

🌊 Streaming Protocol (1,000 frames)

Metric Performance Speedup / Throughput
Streaming Decode (Aligned) 11.8ms ~85,000 frames/s
Streaming Decode (Fragmented) 13.6ms ~73,500 frames/s
Single Frame Latency 139.2µs Real-time instant parsing
Sustained Stream Throughput 12,500 frames/s High-frequency event feeds

🔄 Round-Trip (Encode + Network + Decode)

📡 100 Mbps (Slow Network)

Format Total Time Speedup vs orjson
JSON 114.5ms 0.8x
orjson 91.7ms 1.0x
B-FAST + LZ4 16.1ms 🚀 5.7x

📡 1 Gbps (Fast Network)

Format Total Time Speedup vs orjson
JSON 29.4ms 0.5x
orjson 15.3ms 1.0x
B-FAST + LZ4 7.2ms 🚀 2.1x

📡 10 Gbps (Ultra-Fast Network)

Format Total Time Speedup vs orjson
JSON 20.9ms 0.4x
orjson 7.7ms 1.0x
B-FAST + LZ4 6.3ms 🚀 1.2x

🎯 Ideal Use Cases

  • 📱 Mobile/IoT: 89% data savings + 5.7x performance on slow networks
  • 🌐 APIs with slow networks: Up to 5.7x faster than orjson
  • 📊 Data pipelines: 14-96x speedup for NumPy arrays
  • 🗜️ Storage/Cache: Superior integrated compression
  • 🚀 Simple objects: 4.1x faster than orjson
  • 🌊 Real-time Streaming: > 12,500 frames/s with zero-allocation chunk parsing

📦 Installation

Backend (Python)

uv add bfast-py
or 
pip install bfast-py

Frontend (TypeScript)

npm install bfast-client

🛠️ Basic Usage

Python

import b_fast
from pydantic import BaseModel

class User(BaseModel):
    id: int
    name: str
    email: str

# Create encoder
bf = b_fast.BFast()

# Sample data
users = [User(id=i, name=f"User {i}", email=f"user{i}@example.com") for i in range(1000)]

# Serialize
data = bf.encode_packed(users, compress=True)
print(f"Size: {len(data)} bytes")

# Deserialize
decoded = bf.decode_packed(data)

TypeScript

import { BFastDecoder } from 'bfast-client';

async function loadData() {
    const response = await fetch('/api/users');
    const buffer = await response.arrayBuffer();

    // Decode and decompress automatically
    const users = BFastDecoder.decode(buffer);
    console.log(users);
}

📄 License

Distributed under the MIT License. See LICENSE for more information.