Getting Started

A short tour to get Cowser installed and greeting within a minute.

Table of Contents

Install

pip install cowser

Requires Python 3.8+. See installation.md for other platforms and options.

Your first greeting

cowser Alice

Cowser picks a random animal, wraps "Hi Alice!" in a speech bubble, and prints it. Every run picks a different animal; use --seed 42 for reproducible output.

Pick an animal

cowser --cow owl Bob      # exact name
cowser --cow 12 "Hi!"     # index (see --list)
cowser --cow un "Hello"   # unique prefix also works
cowser --list             # show every animal
cowser --search mythical  # filter by name, category, or tag

Customize the look

cowser --eyes "@.@" --message "Wide eyes!"
cowser --mode dead --cow pig "Feed me"
cowser --think --cow owl "Where am I?"
cowser --rainbow --bold --message "Party time!"
cowser --color green "Moo in green"

Next steps

← Back to README