---
id: relenv
version: "0.22.22"
license: unclear
license_treatment: unclear
maintenance: active
---

# relenv

License: unclear · Maintenance: active · Downloads: 73.5K/mo

## What it is and what it does

Relenv is a tool for creating self-contained Python distributions that bundle the entire interpreter and can be moved between machines and filesystems without reinstallation. Unlike virtualenv or pyenv, which manage package isolation or Python versions respectively, Relenv produces complete, standalone Python builds compiled entirely from source. This makes them reproducible—identical binaries across builds—and relocatable, so you can share a single Relenv build across team members or deploy it to different systems without reconfiguration.

The package itself has no runtime dependencies and installs as a pure Python wheel, making it lightweight to add to a build pipeline. It's designed for scenarios where you need guaranteed consistency across environments or want to distribute Python with your application without relying on system Python or package managers.

Use it for:

- Distribute a consistent Python runtime with a containerized or packaged application across multiple deployment targets.
- Build reproducible Python environments for CI/CD pipelines where binary consistency is required for auditing or compliance.
- Create portable Python setups for teams that need to share identical development environments without per-machine configuration.
- Package Python with compiled extensions for offline or air-gapped deployments where package managers are unavailable.

## Worth the install?

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

Relenv builds self-contained, reproducible Python interpreters from source that can be relocated across filesystems and machines of the same architecture, bundling the entire Python runtime rather than just packages.

Yes, if you need reproducible, relocatable Python builds for distribution or deployment. The active maintenance, zero runtime dependencies, and recent release indicate a stable tool. However, verify the license status before use, and confirm that the compilation overhead and disk footprint of self-contained builds fit your use case—this is not a lightweight alternative to virtualenv, but a specialized distribution mechanism.

## Install

pip install relenv
uv add relenv
poetry add relenv

## Installing relenv

Before you install: Active maintenance with a release 1 day old and no runtime dependencies make installation straightforward. The package is a pure Python wheel with low friction.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before using in proprietary or restricted contexts.

Quickstart:

pip install relenv

import relenv
# Create a reproducible Python build
relenv.build()

Requires source compilation toolchain on the build machine; the resulting builds are relocatable but building them requires a development environment.

Verify before relying:

- Exact Python version support and minimum requirements are not specified in metadata.
- Whether the package itself is licensed under an open-source or proprietary license needs clarification.
- Performance overhead or size impact of self-contained builds compared to standard Python installations.

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 73.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

portable python builds, reproducible python interpreter, relocatable python environment, python from source, self-contained python runtime, python distribution tool, cross-machine python setup, build-automation, python-distribution

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