ducky_py 0.1.0

Your rubber duck debugger pet! Explain your code to Ducky.

Ducky 🐥

Your rubber duck debugger pet! Explain your code to Ducky while you work.

Ducky sits in a small floating window over your code. Feed him, let him sleep, give him a bath, or explain your bugs to him — he'll always have something to quack back!

Installation

pip install ducky

Note: Ducky requires Python 3.12 since it uses pygame. Run with py -3.12 yourfile.py

How to Use

Just add one line at the top of your Python file:

from ducky import show
show()

# Now write your code as normal!
# Ducky will float over your screen while you work.

Buttons

Button	What it does
🍞 Feed	Feed Ducky so he's not hungry
💤 Sleep	Let Ducky take a nap to restore energy
🛁 Bath	Give Ducky a bath to cheer him up
🗣 Explain	Type your code problem — Ducky will respond!

Stat Bars

Bar	What it means
🍞 Hunger	Keep this full by feeding Ducky
💛 Happiness	Pet and interact with Ducky to keep him happy
💤 Energy	Let Ducky sleep when this gets low
🛁 Cleanliness	Give Ducky baths to keep this up

Control Ducky from your code

from ducky import show, feed, sleep, bath, explain

show()

feed()              # feed Ducky
sleep()             # put Ducky to sleep
bath()              # give Ducky a bath
explain("my loop is broken")  # Ducky will respond!

Why Ducky?

Rubber duck debugging is a real technique where you explain your code out loud to a rubber duck — the act of explaining it helps you find the bug yourself. Ducky makes it more fun! 🐥