🌪️ Vortex

📚 Documentation | 📊 Performance Benchmarks

Overview

Vortex is a next-generation columnar file format and toolkit designed for high-performance data analytics. It provides:

⚡️ Blazing Fast Performance
- 100-200x faster random access reads (vs. modern Apache Parquet)
- 2-10x faster scans
- 5x faster writes
- Similar compression ratios
- Efficient support for wide tables with zero-copy/zero-parse metadata
🔧 Extensible Architecture
- Modeled after Apache DataFusion's extensible approach
- Pluggable encoding system
- Zero-copy compatibility with Apache Arrow
🗳️ Open Source, Neutral Governance
- A Linux Foundation (LF AI & Data) Project
- Apache-2.0 Licensed

🟢 Development Status: Library APIs may change from version to version, but we now consider the file format stable. All future releases of Vortex should be able to read files written by version 0.36.0 and later.

Key Features

Core Capabilities

✨ Logical Types - Clean separation between logical schema and physical layout
🔄 Zero-Copy Arrow Integration - Seamless conversion to/from Apache Arrow arrays
🧩 Extensible Encodings - Pluggable physical layouts with built-in optimizations
📦 Cascading Compression - Support for nested encoding schemes
🚀 High-Performance Computing - Optimized compute kernels for encoded data
📊 Rich Statistics - Lazy-loaded summary statistics for optimization

Technical Architecture

Logical vs Physical Design

Vortex strictly separates logical and physical concerns:

Logical Layer: Defines data types and schema
Physical Layer: Handles encoding and storage implementation
Built-in Encodings: Compatible with Apache Arrow's memory format
Extension Encodings: Optimized compression schemes (RLE, dictionary, etc.)

Quick Start

Installation

Rust Crate

All features are exported through the main vortex crate.

cargo add vortex

Python Package

uv add vortex-data

Command Line UI (vx)

For browsing the structure of Vortex files, you can use the vx command-line tool.

# Install latest release
cargo install vortex-tui --locked

# Or build from source
cargo install --path vortex-tui --locked

# Usage
vx browse <file>

Development Setup

Prerequisites (macOS)

# Optional but recommended dependencies
brew install flatbuffers protobuf  # For .fbs and .proto files
brew install duckdb               # For benchmarks

# Install Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# or
brew install rustup

# Initialize submodules
git submodule update --init --recursive

# Setup dependencies with uv
uv sync --all-packages

Performance Optimization

For optimal performance, we suggest using MiMalloc:

#[global_allocator]
static GLOBAL_ALLOC: MiMalloc = MiMalloc;

Project Information

License

Licensed under the Apache License, Version 2.0.

Governance

Vortex is an independent open-source project and not controlled by any single company. The Vortex Project is a sub-project of the Linux Foundation Projects. The governance model is documented in CONTRIBUTING.md and is subject to the terms of the Technical Charter.

Contributing

See CONTRIBUTING.md for guidelines.

Reporting Vulnerabilities

If you discovery a security vulnerability, please email vuln-report@vortex.dev.

Trademarks

Acknowledgments 🏆

This project builds upon groundbreaking work from the academic and open-source communities:

Key Research Papers

BtrBlocks - Efficient columnar compression
FastLanes - High-performance integer compression
FSST - Fast random access string compression
ALP - Adaptive lossless floating-point compression
Procella - YouTube's unified data system
Cloud Object Storage Analytics - High-performance analytics
ClickHouse - Fast analytics for everyone

Open Source Inspiration

Thanks to all contributors who have shared their knowledge and code with the community! 🚀

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

vortex_data-0.40.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (9.3 MB view details)

Uploaded Jun 26, 2025 CPython 3.10+manylinux: glibc 2.17+ x86-64

vortex_data-0.40.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (8.7 MB view details)

Uploaded Jun 26, 2025 CPython 3.10+manylinux: glibc 2.17+ ARM64

vortex_data-0.40.0-cp310-abi3-macosx_11_0_arm64.whl (9.5 MB view details)

Uploaded Jun 26, 2025 CPython 3.10+macOS 11.0+ ARM64

vortex_data-0.40.0-cp310-abi3-macosx_10_12_x86_64.whl (10.0 MB view details)

Uploaded Jun 26, 2025 CPython 3.10+macOS 10.12+ x86-64

File details

Details for the file vortex_data-0.40.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: vortex_data-0.40.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jun 26, 2025
Size: 9.3 MB
Tags: CPython 3.10+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for vortex_data-0.40.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`ca564a83402d610fe1695a2a69d681cb3dc83521c47c6ab3beec4d49c1b07a86`
MD5	`8354b875800ae0c384b83b09737e7ece`
BLAKE2b-256	`e29ec09e731dacddff6fb4982ec8b1b01cb686e5ad12e23d72c50238b9ff9afe`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vortex_data-0.40.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish.yml on vortex-data/vortex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vortex_data-0.40.0-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
- Subject digest: ca564a83402d610fe1695a2a69d681cb3dc83521c47c6ab3beec4d49c1b07a86
- Sigstore transparency entry: 251556206
- Sigstore integration time: Jun 26, 2025
Source repository:
- Permalink: vortex-data/vortex@dae960a0295772713de007a90b41c0e9566f6dfe
- Branch / Tag: refs/tags/0.40.0
- Owner: https://github.com/vortex-data
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@dae960a0295772713de007a90b41c0e9566f6dfe
- Trigger Event: release

File details

Details for the file vortex_data-0.40.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: vortex_data-0.40.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Jun 26, 2025
Size: 8.7 MB
Tags: CPython 3.10+, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for vortex_data-0.40.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`e4e8381139e7734deb16ee726bf1d4aad3fae2dec09d1d3d37a8fcf84637e2d5`
MD5	`6431be1abb86da97c5a7714e2c6de342`
BLAKE2b-256	`7d20f42ab2f70bc19e9999826779bca7052dd40164171be8aff4e9459803606d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vortex_data-0.40.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: publish.yml on vortex-data/vortex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vortex_data-0.40.0-cp310-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
- Subject digest: e4e8381139e7734deb16ee726bf1d4aad3fae2dec09d1d3d37a8fcf84637e2d5
- Sigstore transparency entry: 251556213
- Sigstore integration time: Jun 26, 2025
Source repository:
- Permalink: vortex-data/vortex@dae960a0295772713de007a90b41c0e9566f6dfe
- Branch / Tag: refs/tags/0.40.0
- Owner: https://github.com/vortex-data
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@dae960a0295772713de007a90b41c0e9566f6dfe
- Trigger Event: release

File details

Details for the file vortex_data-0.40.0-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: vortex_data-0.40.0-cp310-abi3-macosx_11_0_arm64.whl
Upload date: Jun 26, 2025
Size: 9.5 MB
Tags: CPython 3.10+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for vortex_data-0.40.0-cp310-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`4a3704faca14db3cd2a01cc73dad1046edd984fa9637754224b030db6f3df162`
MD5	`7e380c18ce337cf075a129252db28e01`
BLAKE2b-256	`56f53fa44ceca3f2a0f795ca357771c22ed38b44aa59ad13855ef54bbd1cc8a1`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vortex_data-0.40.0-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: publish.yml on vortex-data/vortex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vortex_data-0.40.0-cp310-abi3-macosx_11_0_arm64.whl
- Subject digest: 4a3704faca14db3cd2a01cc73dad1046edd984fa9637754224b030db6f3df162
- Sigstore transparency entry: 251556217
- Sigstore integration time: Jun 26, 2025
Source repository:
- Permalink: vortex-data/vortex@dae960a0295772713de007a90b41c0e9566f6dfe
- Branch / Tag: refs/tags/0.40.0
- Owner: https://github.com/vortex-data
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@dae960a0295772713de007a90b41c0e9566f6dfe
- Trigger Event: release

File details

Details for the file vortex_data-0.40.0-cp310-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: vortex_data-0.40.0-cp310-abi3-macosx_10_12_x86_64.whl
Upload date: Jun 26, 2025
Size: 10.0 MB
Tags: CPython 3.10+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for vortex_data-0.40.0-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`3eed921c3b1df3ee7de99bab84c847cb1551e73aefdeeaf9ae6cf69612ad22da`
MD5	`00c1683b217c0c5015637ea9b5575076`
BLAKE2b-256	`f7bc4f37ed13233a65fbbfaa6f113037d8d71786e3c97acdb415fb94e2e76990`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vortex_data-0.40.0-cp310-abi3-macosx_10_12_x86_64.whl:

Publisher: publish.yml on vortex-data/vortex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vortex_data-0.40.0-cp310-abi3-macosx_10_12_x86_64.whl
- Subject digest: 3eed921c3b1df3ee7de99bab84c847cb1551e73aefdeeaf9ae6cf69612ad22da
- Sigstore transparency entry: 251556218
- Sigstore integration time: Jun 26, 2025
Source repository:
- Permalink: vortex-data/vortex@dae960a0295772713de007a90b41c0e9566f6dfe
- Branch / Tag: refs/tags/0.40.0
- Owner: https://github.com/vortex-data
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@dae960a0295772713de007a90b41c0e9566f6dfe
- Trigger Event: release