localpython 0.2.0

Run Python scripts using the local virtual environment without activating it

localpython

Run Python scripts using your local virtual environment — without activating it manually.

localpython is a simple cross-platform CLI tool that automatically detects your local .venv, venv, or env folder and uses its Python interpreter to run a script — just like a smart alias. It can also create virtual environments and install dependencies automatically.

Features

• Runs scripts using .venv/Scripts/python or bin/python
• No need to activate virtual environments manually
• Supports arguments, flags, and quoted paths
• Automatically searches parent directories with -p
• Creates virtual environments and installs dependencies with --setup
• Includes --version, --which, --help

Installation

Install via pip:

pip install localpython

Usage

Basic

localpython script.py

Pass arguments to your script

localpython script.py --input file.json --debug true

Search in parent directories for a venv

localpython -p script.py --some arg

Show path to the interpreter

localpython --which

Show version

localpython --version

Create virtual environment and install dependencies

localpython --setup

This will:

• Check if a virtual environment already exists (and warn if it does)
• Create a .venv directory in the current location
• Automatically detect and install dependencies from common requirements files:
  • requirements.txt, req.txt, requirements-dev.txt
  • requirements-test.txt, dev-requirements.txt, reqs.txt
  • pip-requirements.txt, requirements.pip

Example

Given a project:

myproject/
├── .venv/
├── script.py

And a command:

localpython script.py --run fast

This tool will automatically run:

./.venv/Scripts/python script.py --run fast

(Or the Unix equivalent if on Linux/Mac)

License

This project is licensed under the MIT License.

Author

Created by Yali Ach