Skip to main content

pip-art logo

pip-art

Why stare at boring logs? Turn any long-running command into a surprise art show in your terminal!

PyPI Python version License


🎨 The Philosophy

You run pip install, npm install, or docker build and watch lines of text scroll by. It's functional, but it's joyless.

pip-art transforms this dead time into a moment of discovery and delight. It hides the messy logs and displays a random piece of art from a community-driven gallery, turning your terminal into a tiny art museum while you wait.

Screenshot of pip-art in action

When the command is done, you get your terminal back, plus a final success or failure report.

🚀 Features

  • Universal: Works with any command, not just pip.
  • Clean Experience: Hides command output for a calm, clutter-free wait.
  • GIF & PNG & JPG Support: The gallery welcomes static images and animations.
  • Community-Powered: All art comes from a public GitHub repository. Anyone can contribute!
  • Fully Customizable: Don't like the public gallery? Create your own! A simple config file lets you point pip-art to any gallery you want.

🛠️ Installation

pip install pip-art

💡 How to Use

Just prefix any command with pip-art:

# Instead of this...
pip install numpy pandas tensorflow

# ...do this!
pip-art pip install numpy pandas tensorflow
# Works with any command
pip-art npm install
pip-art docker build .

🖼️ Curate Your Own Experience: The Config File

This is where pip-art becomes your tool. You can tell it to use your very own art gallery instead of the public one. Want a gallery of only cat pictures? Or 8-bit landscapes? You can do it!

How it works:

  1. Create a config file: In your user's home directory, create a file named .pip-art.toml.

    • On Windows: C:\Users\YourUser\.pip-art.toml
    • On Linux/macOS: ~/.pip-art.toml
  2. Add your gallery: Inside this file, add one line:

    # Point to your own GitHub repository's "images" folder
    gallery_repo = "YOUR_USERNAME/YOUR_GALLERY_REPO_NAME"
    

That's it! The next time you run pip-art, it will fetch art from your repository.

To go back to the default community gallery, simply delete or comment out this line.

🤝 How to Contribute

There are two great ways to contribute to the pip-art ecosystem:

Have a great piece of art everyone should see? Add it to the main gallery!

The process is managed through our gallery repository: pip-art-gallery.

  1. Prepare your files:

    • Image File: A PNG, JPG, or an animated GIF.
    • Metadata File (Optional but Recommended): A .json file with the exact same name as your image (e.g., my-art.json for my-art.png).
  2. Metadata Format: This is how we credit you!

    {
      "title": "Your Artwork Title",
      "author": "Your Name / Nickname",
      "description": "A short, fun description of your art."
    }
    
  3. Submit a Pull Request: Go to the gallery repo, upload your files to the images folder, and open a PR.

Made a cool themed gallery? Share it! Create a public GitHub repository, fill the images folder with art, and tell people to use your gallery_repo link in their config file.


This project is licensed under the MIT License. Made with ❤️ to make the terminal a more joyful place.

Metadata

Release files for pip-art 0.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pip-art 0.1.5
File Size Uploaded Provenance Actions
pip_art-0.1.5.tar.gz 20.1 kB Without provenance Details for pip_art-0.1.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pip-art 0.1.5
File Interpreter ABI Platform Actions
pip_art-0.1.5-py3-none-any.whl Python 3 none any Details for pip_art-0.1.5-py3-none-any.whl

Total release size: 37.5 kB

Release files / pip_art-0.1.5.tar.gz

Download URL pip_art-0.1.5.tar.gz
Size 20.1 kB
Tags Source
SHA-256 checksum
How to use checksums
36d9d5bf7b38ab826e33cca8cc994732e4304edb6b4219b1e715d21cc6c03941
BLAKE2b-256 checksum
How to use checksums
63e33c73aea3d32ad1d95f5f28a5687757fab0f86cd988020050a55d4a9b2441
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.4

Release files / pip_art-0.1.5-py3-none-any.whl

Download URL pip_art-0.1.5-py3-none-any.whl
Size 17.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
85b74f08ca890744db459918a2f88f098b7c75af06926953e0f7130eb4d06269
BLAKE2b-256 checksum
How to use checksums
a6d3ebf71caecfd68da13138711e18d4c1e11e1aada3f786b3ace57054e47fef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.4

Security for pip-art 0.1.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.5 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page