# vortex-data/vortex

> vortex is a columnar file format and toolkit designed for high-performance data processing in data systems backed by object storage. It stores data as encoded columns and separates the logical schema from the physical layout, so encodings and compression strategies can be swapped in as plugins. Its main language is Rust, with Python, C++, Java and TypeScript code also in the repository.

Source: https://github.com/vortex-data/vortex
Indexed: commit a272f51 on 2026-08-13 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Command-line tool
- Language: Rust
- Stars: 3,319 at index time
- License: Apache-2.0
- Code health: 7.6/10, Good
- Last commit: 2026-08-13
- Contributors: 33

## Install

From the README: https://github.com/vortex-data/vortex#installation

Clone the vortex repository.
    git clone https://github.com/vortex-data/vortex.git

Move into the vortex folder.
    cd vortex

Add the Rust crate to a Cargo project.
    cargo add vortex

Install the Python package with uv.
    uv add vortex-data

Install the vx command-line tool from a pre-built binary.
    cargo binstall vortex-tui

## How it works

Logical types and schema are defined separately from the physical layout, which handles encoding and storage. The encodings directory holds the encoding implementations, which are the pluggable physical layouts that compress column data. The vortex-layout module handles how encoded data is arranged and read, and the vortex-array module is the largest module, with 769 files. The vortex-python module provides the Python package, and vortex-duckdb connects vortex to DuckDB. Data read from a vortex file keeps its encoded form, and compute kernels operate on that encoded data directly.

- .github/scripts/fuzz_report/__main__.py: entry point
- bench-orchestrator/bench_orchestrator/cli.py: entry point
- benchmarks/bench-support/src/lib.rs: entry point
- benchmarks/compress-bench/src/lib.rs: entry point
- benchmarks/compress-bench/src/main.rs: entry point
Modules: vortex-array, encodings, vortex-bench, vortex-python, vortex-cuda, vortex-duckdb, vortex-layout, java. 2,724 files, 421,152 lines, 37,846 symbols.

## Code health

- Score: 7.6/10 (Good)
- Rank: #101 of 4,000+ indexed repos
- Hotspots: vortex-ffi/cinclude/vortex.h, vortex-file/src/tests.rs, vortex-ffi/src/array.rs, vortex-array/src/scalar_fn/fns/binary/numeric/primitive.rs, vortex-array/src/arrays/varbin/compute/take.rs
- Lowest file: vortex-array/src/compute/conformance/consistency.rs
- Dead code: 376 findings

## Maintenance

- Last commit 2026-08-13, first commit 2026-06-18, 500 commits
- 33 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/vortex-data/vortex/security

## More

- Page: https://repowise.dev/repo/vortex-data/vortex
- Ask this codebase: https://repowise.dev/repo/vortex-data/vortex/chat
- Docs: https://repowise.dev/repo/vortex-data/vortex/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/vortex-data/vortex
