pypm-cli 0.0.3

Automatic, AST-based dependency inference from Python imports. Stop writing dependencies twice.

pypm – Python Package Manager

pypm is a zero-config CLI tool that automatically infers dependencies from your Python source code.

Stop writing dependencies twice. Let your imports define your project.

pypm parses your project using Python’s AST, detects imports, resolves them to their correct PyPI package names (e.g., PIL → Pillow, cv2 → opencv-python), and generates a modern pyproject.toml for you.

🚀 Installation

Install from PyPI:

pip install pypm-cli

After installation, you can run:

pypm --help

⚡ Quick Start

1️⃣ Infer Dependencies

Scan the current directory and generate/update pyproject.toml:

pypm infer

2️⃣ Infer + Install Dependencies

Infer and install packages automatically:

pypm install

Note: If uv is available, it will be used for faster installs. Otherwise, it falls back to pip.

✨ Features

• Blazing Fast: Scans 1000+ files in under 1 second using aggressive parallelism and local caching.
• Offline-First Mapping: Uses a bundled database of popular packages to resolve dependencies instantly without network.
• Smart Inference: Recursively scans your project for .py files and extracts all imports.
• Automatic Resolution: Maps module names to actual PyPI packages (e.g., PIL → Pillow).
• Standard Library Detection: Automatically ignores Python built-in and stdlib modules.
• Modern Standards: Generates PEP 621–compliant pyproject.toml.

📌 Example Workflow

# Inside your Python project
pypm infer

# Review generated pyproject.toml
cat pyproject.toml

# Install dependencies
pypm install

🧠 Why pypm?

Manually maintaining dependencies leads to:

• Duplicate effort
• Forgotten imports
• Mismatched environments
• Dirty requirements.txt files

pypm makes your imports the single source of truth.

📚 Documentation

See full documentation in: docs/

🔧 Development Setup

If you want to contribute or run locally:

git clone https://github.com/Suriyakumardurai/pypm.git
cd pypm
pip install -e .

📦 Project

Available on PyPI: https://pypi.org/project/pypm-cli/