catmemes 0.2.1

Retrieve famous cat memes (ascii and image)

catmeme retriever

In the long history of cat memes, people who have too much spare time (like me) do need a curated collection of good ones.

Installation

pip install catmemes

Make sure to set terminal font as cica to better support CJK alignment in ascii art.

CLI ascii cats

Adopt four ascii cats:

　　　　 ∧___∧　　　   ∧___∧　　　　　　　　　　            ∧  ∧___
　　　　(　´∀` )　　　( ・∀・)　　　　　　　　　　　　　　  /(*ﾟーﾟ)./\
　　　　(　　  )　　  ( 　　 )　　　　　　　　　∧ ∧　 　  /|￣U U￣|\/
　　　  |  |  | 　 　|  |  | 　　　 ～′￣￣(,,ﾟДﾟ)　 　  |　 　  |/
　　　　(___)__）　　 (___)__)　　　　  UU￣U U           ￣￣￣￣

        Mona        Moralar          Giko             Shii

The full collection of derivatives is available here.

Usage

Adopt a cat by name

ascii-cat list         # list all cat names
ascii-cat [cat_name]   # you guys have too much spare time ~

Iconic cat memes

Search for the most relevant meme from a self-collected dataset

Usage

Create conda environment:

conda create -n catmemes python=3.13
conda activate catmemes
pip install -r requirements.txt

Start backend and frontend by running the following two commands in backend and frontend folder:

uvicorn app:app --reload --port 8000
npm run dev

Find the history of each meme here.

Acknowlegement

Partially inspired by this Youtube video. In tribute to the iconic feline celebrities who have brought joy to millions.

And I miss my cat kupo.