pybuild-x 🚀

pybuild-x is a lightweight CLI utility designed to eliminate the repetitive boilerplate of creating and publishing Python packages. In a single command, it sets up your project structure, generates a professional README.md using Gemini AI, compiles the build artifacts, and uploads everything straight to PyPI.

⚡ This package was built and published to PyPI using pybuild-x itself. No code was harmed during this recursion.

📦 Features

• Instant Packaging: Automatically turns a single .py file into a full PEP-compliant package structure (setup.py, _init_.py, dist/).
• AI-Powered Documentation: Uses Gemini API (gemini-2.5-flash) to draft clean Markdown documentation based on a short description.
• Auto-Toolchain Setup: Automatically checks for and installs missing dependencies (build, twine, setuptools).
• One-Click PyPI Upload: Compiles wheels/tarballs and pushes them to PyPI seamlessly with --autoupload.
• Smart Fallback: Uses local README-<name>.md if no AI prompt is passed.

⚙️ Installation & Requirements

Set your Gemini API key in your terminal environment before running:

$env:gemini_api_key = "key"
# 🚀 Usage
1. Basic Package Generation
Creates the package folder, setup.py, and README.md locally without publishing:

```Bash
python pybuild_x.py -f "path/to/script.py" -d "A neat script for automation"

2. Full Automation & PyPI Upload Generates everything and automatically publishes to PyPI:

python pybuild\_x.py -f "path/to/script.py" -d "A neat script for automation" --autoupload

3. Specify Custom Version Sets a custom version for setup.py (default is 0.1.0):

python pybuild_x.py -f "path/to/script.py" -v "1.0.0" --autoupload

📄 License MIT License © 2026