Skip to main content

🎨 artlab

ASCII art in your terminal.

Bundled retro art, big block-letter text, rainbow colors, and animation. Zero dependencies. Works in Python 3.8+.

PyPI Python License Docker


Why artlab?

Because the terminal deserves a little personality.

  • Bundled ASCII art — robots, cats, dragons, unicorns, yoda, octopuses, hearts and more.
  • Block-letter text — print any word big, figlet-style, with zero dependencies.
  • Rainbow & colors — 256-color palettes, or dims down for your pipelines.
  • Animation — reveal art with a slick frame-by-frame intro.
  • Zero dependencies — pure Python stdlib. No install drama.

Install

pip install artlab

Or run without installing:

pipx run artlab --help

Via Docker:

docker run --rm ghcr.io/dsk-dev-ai/artlab --help

Usage

# Show a random piece
artlab

# Show a specific piece
artlab robot
artlab cat
artlab dragon

# List everything
artlab -l

# Print big block text
artlab --text "SHIP IT"
artlab -t "artlab" -c cyan

# Force a palette
artlab robot -c green
artlab dragon -c magenta

# Animate the reveal
artlab unicorn -a

# No color (for scripts / piping)
artlab robot --no-color

Options

Flag Description
-l, --list List all available pieces
-r, --random Show a random piece
-t, --text TEXT Render text as big block letters
-c, --color Palette: rainbow, green, cyan, magenta, none
-w, --width N Pad art to a fixed width
--no-center Don't center the art
-a, --animate Reveal the art with an animation
--no-color Disable color output
--version Print version

Gallery

Run artlab to see a random piece, or artlab -l to browse the full library. Everything is bundled — no API, no network, no nonsense.

   /\_/\
  ( o.o )
   > ^ <
  /     \
  \_____/  meow

Tests

python -m pytest

Tested on Python 3.8–3.12 via GitHub Actions.

Sponsor

Like artlab? Keep the terminal artsy for free by becoming a sponsor on GitHub 💜.


artlab · because the terminal deserves art.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

artlab-1.0.0.tar.gz (8.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

artlab-1.0.0-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

File details

Details for the file artlab-1.0.0.tar.gz.

File metadata

  • Download URL: artlab-1.0.0.tar.gz
  • Upload date:
  • Size: 8.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for artlab-1.0.0.tar.gz
Algorithm Hash digest
SHA256 7580736443ce523d44d348912710a221ed38ba9f13e1b1a44c5c58dfe088a1a8
MD5 07bbc5647edd31c4284f66891afe4428
BLAKE2b-256 3dc313269917b53fcc41192f373e576eb4606240546959a715aa080403436f74

See more details on using hashes here.

File details

Details for the file artlab-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: artlab-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 8.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for artlab-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f395ea7c94f4e0472312c674641790f8357c5e35a9392aabc89c74002992c24b
MD5 7f5a82bf1ed3063aefa657fa7ce3c0bc
BLAKE2b-256 2ac2178f05a914fce11b6491cb4ae9690242bfc2e28f980f8e71492d6d348d53

See more details on using hashes here.

Release history Release notifications | RSS feed

1.0.1

2 files

This release

1.0.0 This release

2 files

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