---
id: pyvrl
version: "0.0.2"
license: unclear
license_treatment: permissive
maintenance: dormant
---

# pyvrl — Exposes Vector VRL to Python

License: permissive · Maintenance: dormant · Downloads: 575.8K/mo

## What it is and what it does

pyVRL is a Python binding to Vector's VRL, a domain-specific language for data transformation. It lets you define data remapping logic as VRL programs and apply them to Python dictionaries through a Transform object. The package compiles to native code via Rust, providing performance benefits for data pipeline operations.

The typical workflow is to instantiate a Transform with a VRL program string, then call its remap() method on data dictionaries. VRL supports field manipulation, function calls (like upcase! and uuid_v7()), and conditional logic. The project is minimal and dormant—last updated in May 2024—with no runtime dependencies beyond Python itself.

Use it for:

- Transform and normalize structured data fields in ETL pipelines using VRL syntax
- Apply consistent remapping rules to event or log data before storage or downstream processing
- Generate derived fields (like UUIDs or transformed values) during data ingestion workflows

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Exposes Vector's VRL (Vector Remap Language) to Python, enabling fast data transformation and remapping using VRL programs.

Yes, if you are already using Vector and want to apply VRL transforms within Python code. The permissive license and zero runtime dependencies make it low-risk to add. However, the project's dormant status and lack of documentation beyond a single example mean you should verify that VRL's feature set meets your transformation needs and be prepared to work from the Vector VRL documentation directly.

## Install

pip install pyvrl
uv add pyvrl
poetry add pyvrl

## Installing pyvrl

Before you install: Medium install friction due to compiled wheels across multiple platforms and Python versions. Project is dormant since May 2024 with no recent maintenance activity, though the repository remains active.

License in practice: Licensed under MIT (permissive), allowing broad use, modification, and distribution with minimal restrictions.

Quickstart:

pip install pyVRL

from pyvrl import Transform
data = {"x": "foo"}
vrl_program = '.y = "bar"\n.x = upcase!(.x)\n.'
transform = Transform(vrl_program)
output = transform.remap(data)

Requires Python 3.10 or later; compiled wheels are provided for common platforms but may require building from source on unsupported architectures.

Verify before relying:

- Whether VRL program syntax and capabilities are documented beyond the single example provided
- Performance characteristics and typical use-case scale compared to native Python transforms
- Whether the project will receive updates for future Python versions beyond 3.10+

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: dormant
- Downloads: 575.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vrl vector remap language python, data transformation remapping, vector data pipeline, fast data remapping, vrl python bindings, data-transformation, rust-bindings

[View on SkillFed](https://skillfed.io/packages/pyvrl) · [View on PyPI](https://pypi.org/project/pyvrl/)