---
id: pox
version: "0.3.7"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# pox — utilities for filesystem exploration and automated builds

License: permissive · Maintenance: active · Downloads: 18.0M/mo

## What it is and what it does

Pox is a collection of filesystem and environment utilities that complement Python's built-in `os` and `shutil` modules. It provides Python equivalents of Unix shell commands like `which` and `find`, along with functions to discover user environment details (home directory, login shell, preferred user name) and manipulate environment variables. The package is particularly useful for remote system administration and automated builds, where you need to programmatically discover what tools are installed and where they live on a system.

The package also offers higher-level operations: finding the location of an installed Python package, determining if source code exists on the filesystem, querying package versions, and abstracting commands for remote execution. It has no runtime dependencies and is part of the larger pathos framework for heterogeneous computing, making it a lightweight addition to build scripts and system exploration workflows.

Use it for:

- Discover the path to an executable or Python interpreter on a local or remote system without shell invocation.
- Expand environment variables in configuration paths or build scripts programmatically.
- Locate installed Python packages and their source code directories for introspection or manipulation.
- Automate cross-platform build and installation scripts that need to query the user's home directory and shell preferences.
- Abstract filesystem commands for execution across distributed or parallel pipes in heterogeneous computing setups.

## Worth the install?

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

Pox provides utilities for filesystem exploration, environment variable manipulation, and automated discovery of installed tools and packages—useful for both local and remote system interaction.

Yes. Pox is a lightweight, dependency-free utility library with active maintenance, permissive licensing, and no known vulnerabilities. Install it if you need programmatic filesystem exploration, environment variable handling, or automated discovery of system tools—particularly valuable in build automation and remote system administration scripts.

## Install

pip install pox
uv add pox
poetry add pox

## Installing pox

Before you install: Low install friction with no runtime dependencies. Actively maintained as of 2026-06-22, with production-stable status and support for current Python versions (3.9 through 3.14).

License in practice: Distributed under BSD-3-Clause, a permissive license allowing commercial and private use with minimal restrictions—suitable for most projects.

Quickstart:

pip install pox

import pox
print(pox.homedir())
print(pox.which('python3.9'))
print(pox.expandvars('${HOME}/dev'))

Requires Python >=3.9 and setuptools >=42.

Verify before relying:

- Whether pox's remote filesystem abstraction works with specific SSH or connection libraries beyond what the description implies.
- Performance characteristics when searching deeply nested filesystems or across many environment variables.

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 18.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

filesystem exploration utilities, find executable in path, environment variable expansion, remote host filesystem access, discover installed packages, python which command, automated build utilities, filesystem-utilities, build-automation, remote-execution

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