pip-art
Why stare at boring logs? Turn any long-running command into a surprise art show in your terminal!
🎨 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.
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-artto 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:
-
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
- On Windows:
-
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:
1. Add Art to the Main Community Gallery
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.
-
Prepare your files:
- Image File: A
PNG,JPG, or an animatedGIF. - Metadata File (Optional but Recommended): A
.jsonfile with the exact same name as your image (e.g.,my-art.jsonformy-art.png).
- Image File: A
-
Metadata Format: This is how we credit you!
{ "title": "Your Artwork Title", "author": "Your Name / Nickname", "description": "A short, fun description of your art." }
-
Submit a Pull Request: Go to the gallery repo, upload your files to the
imagesfolder, and open a PR.
2. Create Your Own Gallery to Share
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.