Skip to main content

High-performance, Rust-backed columnar kernel for stock / candlestick (OHLCV) time-series data.

Project description

volas

High-performance, Rust-backed columnar kernel for stock / candlestick (OHLCV) time-series data.

Status: early development — version 0.0.0. APIs are not yet stable and may change at any time.

What is volas?

volas is a focused, DataFrame-like data structure purpose-built for financial candlestick (OHLCV) time series and quantitative-trading workflows.

Rather than being a general-purpose DataFrame, volas supports only what this domain needs — a time-indexed, two-dimensional table of numeric and boolean columns — and implements its storage and compute core in Rust for low, predictable latency on incremental ("append one bar") workloads.

Goals

  • Live-trading first — optimized for the incremental hot path: append a new bar, update indicators, read the result, with minimal per-bar latency.
  • Small, regular data model — a time index plus 2-D columns of numbers and booleans; no multi-level indexes, no heterogeneous storage, no general-purpose reshaping.
  • Rust core — storage and computation live in a compiled Rust extension.
  • First-class NumPy interop — zero-copy to_numpy export, designed so data flows cheaply into NumPy and torch.Tensor for both training and inference.

Installation

Not yet published to PyPI. For a local build, see Development.

pip install volas

Requires Python >= 3.11.

Usage

Preview of the intended API. Not yet implemented at 0.0.0; subject to change.

from volas import Volas

v = Volas({
    'open':   [...],
    'high':   [...],
    'low':    [...],
    'close':  [...],
    'volume': [...],
})

# Zero-copy export to NumPy (where possible)
close = v['close'].to_numpy()
matrix = v.to_numpy()

Development

Requires Python >= 3.11 and a Rust toolchain.

# Build the Rust extension and install the package in-place (development)
make build

# Build a release wheel + sdist into dist/
make build-pkg

# Publish to PyPI (build + upload)
make publish

License

MIT

Project details


Download files

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

Source Distribution

volas-0.0.0.tar.gz (6.0 kB view details)

Uploaded Source

Built Distribution

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

volas-0.0.0-cp312-cp312-macosx_11_0_arm64.whl (178.2 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

File details

Details for the file volas-0.0.0.tar.gz.

File metadata

  • Download URL: volas-0.0.0.tar.gz
  • Upload date:
  • Size: 6.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for volas-0.0.0.tar.gz
Algorithm Hash digest
SHA256 839efa482e15d5490d676b288ff3bcaaa9a4f4e52e0ae5ccc5c867bfb7c8f341
MD5 1524ae12e1d7c5c363d9428bac054a2e
BLAKE2b-256 78737bb81851504515285f12e0edf7ce73aa7cdd58f9e175dac080b0b279d2b4

See more details on using hashes here.

File details

Details for the file volas-0.0.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for volas-0.0.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d9c1c92ff528fe69948acea69df9bf3336ba5a9e96a887bd562464b9cce843d3
MD5 ecd996018ec2d045c9d30b308b61e4e1
BLAKE2b-256 850c18f8e288345a550a1def7041eb0dc22698a7eaff49c25e80c0f51a506423

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page