Metadata-Version: 2.4
Name: vane-ai
Version: 0.1.0a1
Summary: A distributed, multimodal data engine built on DuckDB and Ray
Keywords: Vane,DuckDB,Ray,Distributed,Database,SQL,OLAP
Author: Vane contributors
Maintainer: Vane maintainers
License-Expression: Apache-2.0
License-File: LICENSE
License-File: LICENSES/DuckDB-MIT.txt
License-File: LICENSES/vcpkg-binary-dependencies.txt
License-File: NOTICE
License-File: duckdb/experimental/spark/LICENSE
License-File: external/duckdb/LICENSE
License-File: external/duckdb/extension/icu/third_party/icu/LICENSE
License-File: external/duckdb/extension/jemalloc/jemalloc/LICENSE
License-File: external/duckdb/src/include/duckdb/storage/compression/alp/algorithm/LICENSE
License-File: external/duckdb/src/include/duckdb/storage/compression/alprd/algorithm/LICENSE
License-File: external/duckdb/third_party/brotli/LICENSE
License-File: external/duckdb/third_party/concurrentqueue/LICENSE
License-File: external/duckdb/third_party/fast_float/LICENSE
License-File: external/duckdb/third_party/fastpforlib/LICENSE
License-File: external/duckdb/third_party/fmt/LICENSE
License-File: external/duckdb/third_party/fsst/LICENSE
License-File: external/duckdb/third_party/httplib/LICENSE
License-File: external/duckdb/third_party/hyperloglog/LICENSE
License-File: external/duckdb/third_party/jaro_winkler/LICENSE
License-File: external/duckdb/third_party/libpg_query/LICENSE
License-File: external/duckdb/third_party/lz4/LICENSE
License-File: external/duckdb/third_party/mbedtls/LICENSE
License-File: external/duckdb/third_party/miniz/LICENSE
License-File: external/duckdb/third_party/parquet/LICENSE
License-File: external/duckdb/third_party/pcg/LICENSE
License-File: external/duckdb/third_party/pdqsort/LICENSE
License-File: external/duckdb/third_party/re2/LICENSE
License-File: external/duckdb/third_party/ska_sort/LICENSE
License-File: external/duckdb/third_party/skiplist/LICENSE
License-File: external/duckdb/third_party/snappy/LICENSE
License-File: external/duckdb/third_party/snowball/LICENSE
License-File: external/duckdb/third_party/tdigest/LICENSE
License-File: external/duckdb/third_party/tdigest/NOTICES
License-File: external/duckdb/third_party/thrift/thrift/LICENSE
License-File: external/duckdb/third_party/utf8proc/LICENSE
License-File: external/duckdb/third_party/vergesort/LICENSE
License-File: external/duckdb/third_party/yyjson/LICENSE
License-File: external/duckdb/third_party/zstd/LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Database
Classifier: Topic :: Database :: Database Engines/Servers
Classifier: Topic :: Scientific/Engineering
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: C++
Project-URL: Documentation, https://github.com/AstroVela/vane#readme
Project-URL: Source, https://github.com/AstroVela/vane
Project-URL: Issues, https://github.com/AstroVela/vane/issues
Project-URL: Changelog, https://github.com/AstroVela/vane/releases
Requires-Python: <3.13,>=3.10
Requires-Dist: cloudpickle<4,>=3.1.2
Requires-Dist: numpy
Requires-Dist: pyarrow
Requires-Dist: ray<3,>=2.53.0
Provides-Extra: openai
Requires-Dist: openai; extra == "openai"
Provides-Extra: anthropic
Requires-Dist: anthropic; extra == "anthropic"
Provides-Extra: google
Requires-Dist: google-genai; extra == "google"
Provides-Extra: transformers
Requires-Dist: sentence-transformers; extra == "transformers"
Requires-Dist: torch; extra == "transformers"
Requires-Dist: transformers; extra == "transformers"
Provides-Extra: vllm
Requires-Dist: vllm; platform_system == "Linux" and platform_machine == "x86_64" and extra == "vllm"
Provides-Extra: all
Requires-Dist: anthropic; extra == "all"
Requires-Dist: google-genai; extra == "all"
Requires-Dist: ipython; extra == "all"
Requires-Dist: fsspec; extra == "all"
Requires-Dist: openai; extra == "all"
Requires-Dist: pandas; extra == "all"
Requires-Dist: adbc-driver-manager; extra == "all"
Description-Content-Type: text/markdown

<h1 align="center">
  <img src="assets/vane-logo.svg" alt="VANE" width="336" height="96">
</h1>

<p align="center">
  <strong>A high-performance, multimodal-native engine for AI workloads</strong>
</p>

<p align="center">
  <a href="https://test.pypi.org/project/vane-ai/">
    <img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Ftest.pypi.org%2Fpypi%2Fvane-ai%2Fjson&amp;query=%24.info.version&amp;label=TestPyPI&amp;logo=pypi" alt="TestPyPI">
  </a>
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/license-Apache--2.0-green.svg" alt="Apache License 2.0">
  </a>
  <a href="https://deepwiki.com/AstroVela/vane">
    <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
  </a>
</p>

<p align="center">
  <a href="https://discord.gg/BuKhPQcqs">
    <img src="https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&amp;logoColor=white&amp;style=for-the-badge" alt="Join Discord">
  </a>
  <a href="https://x.com/AstroVelaAI">
    <img src="https://img.shields.io/badge/X-Follow_%40AstroVelaAI-black?logo=x&amp;style=for-the-badge" alt="Follow AstroVelaAI on X">
  </a>
</p>

Vane unifies multimodal data, intelligence, and continuous learning with Python and SQL interfaces, seamlessly scaling from local environments to Ray clusters.

![Vane platform overview](assets/vane-platform.png)

> [!NOTE]
> **Project status**
>
> - **Vane Data** — Supports most of the capabilities described below and is under active development, but is **not yet production-ready**. Its interfaces and internals may continue to evolve as the codebase is reviewed and hardened.
> - **Vane RL** and **Vane Agent** — In the early stages of design and implementation. Their source code will be released in future updates.
  - **Vibe Coding and Agentic Engineering** — Some parts of our system were initially built through Vibe Coding. We are now continuously analyzing, understanding, and improving the codebase, applying an Agentic Engineering approach to drive iterative optimization and enhance the quality, maintainability, and efficiency of the system.

---

## Vane Data

Vane Data is a high-performance, multimodal-native data engine for AI workloads. Built on a fork of [DuckDB](https://duckdb.org), it extends the core execution engine with native multimodal processing and a unified framework for local and distributed execution.

![Vane Data architecture](assets/vane-data.png)

### Key Features

- **Multimodal-native processing** — Process images, video, audio, text, documents, events, sensor data, and tables through a unified type system. Dynamic batching and backpressure control handle variations in data size and computational cost.
- **Python and SQL interfaces** — Build data and AI pipelines with DuckDB SQL or the Python Relation API.
- **Built-in AI operations** — Invoke LLMs, generate embeddings, and run batch inference through OpenAI and Anthropic APIs or native vLLM integration. Prefix-aware bucketing improves vLLM prefix-cache hit rates and inference throughput.
- **Heterogeneous execution** — Overlap CPU, GPU, I/O, and model inference workloads through asynchronous scheduling.
- **Local-to-cloud execution** — Run the same pipeline locally or across distributed Ray clusters, with a foundation for future edge-cloud coordination.
- **Designed for production AI workloads** — Build multimodal training-data preprocessing pipelines and enterprise-scale batch inference workflows.

---

## Getting Started

### Installation

Vane supports Python 3.10, 3.11, and 3.12. Python 3.12 is recommended and is the primary development version.

Install the `vane-ai` package from PyPI:

```bash
pip install vane-ai
```

For more details, see the [Installation Guide](https://vane.astrovela.ai/docs/data/quickstart/installation).

### Quick Start

Follow the [Quickstart guide](https://vane.astrovela.ai/docs/data/quickstart/quickstart) to build and run your first Vane pipeline.

### More Resources

- [Examples](https://vane.astrovela.ai/docs/data/examples)
- [Production deployment](https://vane.astrovela.ai/docs/data/contributing/development)

---

## Multimodal Inference Benchmarks

Hardware configuration: 1 node, 36 CPU cores, 64 GB memory, and 1× NVIDIA GeForce RTX 2080 Ti (22 GB VRAM).

We use the [Ray Data benchmark suite](https://www.anyscale.com/blog/ray-data-daft-benchmarking-multimodal-ai-workloads) to compare Vane with Ray Data and Daft. The [benchmark source code](multimodal_inference_benchmarks) is included in this repository.

![Multimodal inference benchmark comparing Vane Data, Ray Data, and Daft](assets/benchmark.png)

The Ray runner targets distributed workloads. The current results are single-node only; validation on the multi-node environments used in the Ray Data benchmarks is still pending.

See the [benchmarking page](https://vane.astrovela.ai/benchmarks) for detailed results.

---

## Contributing

Contributions and collaborations are welcome. Contribution guidelines and community channels will be published as the project opens further.

---

## License

Vane is distributed under the Apache License 2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE) for details and third-party attributions.

---

## Acknowledgements

Vane Data is built on top of DuckDB and inspired by infrastructure systems such as Ray Data, Daft, and Trino.
*   **[DuckDB](https://github.com/duckdb/duckdb)**: The core modular architecture and inspiration. A high-performance analytical database system. It is designed to be fast, reliable, portable, and easy to use.
*   **[DuckDB-Python](https://github.com/duckdb/duckdb-python)**: The core modular architecture and inspiration. The DuckDB Python package.
*   **[Ray Data](https://github.com/ray-project/ray)**: A scalable data processing library for AI workloads built on Ray
*   **[Daft](https://github.com/eventual-inc/daft)**: High-Performance Data Engine for AI and Multimodal Workloads
*   **[Trino](https://github.com/trinodb/trino)**: A fast distributed SQL query engine for big data analytics.

**Special thanks to these projects.**

---

<div align="center">

**Give Vane a ⭐️ if it helps you!**

</div>
