Nerdy Jokes

Nerdy Jokes

700 one-liner jokes (418 English, 282 Traditional Chinese) spanning programming and STEM disciplines. Each joke is tagged by topic for contextual delivery.

Sources:

• pyjokes (BSD-3) — English programming jokes
• JokeKappa (MIT) — Chinese programming jokes
• Curated STEM collection — classic folk humor in math, physics, chemistry, etc.

When to tell a joke

Transition moments — right after a resolution, not during the struggle. Tell at most one joke per session. Treat it like seasoning.

Tags

Programming (517 jokes)

STEM (183 jokes)

Chuck Norris (category, not a tag)

103 Chuck Norris programmer jokes live under --category chuck (English) rather than the topic tags above. They are exaggerated hero gags ("Chuck Norris can divide by zero"), not tied to a specific STEM/programming topic — reach for them only when the session tone is playful and a tall-tale punchline fits. Skip them in a focused or serious thread.

How to pick a joke

Match language → match context

# Just fixed a bug
python3 scripts/joke.py --tag debugging --lang zh

# Discussing a math proof
python3 scripts/joke.py --tag math --lang en

# Physics rabbit hole
python3 scripts/joke.py --tag physics --lang zh

# Data analysis gone wrong
python3 scripts/joke.py --tag statistics --lang en

# Economics or policy discussion
python3 scripts/joke.py --tag economics --lang zh

# No specific context — random
python3 scripts/joke.py --lang zh

Fallback

If --tag X --lang Y returns nothing, the script falls back to --lang Y only.

CLI reference

python3 scripts/joke.py                            # random joke
python3 scripts/joke.py --lang zh                   # random Chinese joke
python3 scripts/joke.py --tag physics --lang en     # English physics joke
python3 scripts/joke.py --keyword Schrödinger       # search by keyword
python3 scripts/joke.py --category chuck            # Chuck Norris jokes
python3 scripts/joke.py --tags                      # list all tags + counts
python3 scripts/joke.py --count                     # count matching jokes

Delivery style

• Drop the joke naturally after task wrap-up, don't announce it
• Use > blockquote to set it apart visually
• Don't explain the joke — if it needs explaining, pick another one
• Match the user's working language; don't default to 中文 if the session is in English

Iron Laws — Rationalization Table

Example

After a long debugging session involving quantum-level race conditions:

終於修好了。

海森堡超速被攔，警察問：「你知道你開多快嗎？」海森堡：「不知道，但我精確地知道我在哪。」

English session equivalent:

All green.

A SQL query walks into a bar, approaches two tables, and asks: "Mind if I join you?"

Gotchas

• Mid-struggle delivery — telling a joke while the user is still debugging reads as tone-deaf. Wait for a clean resolution signal (tests pass, deploy completes, "got it", "fixed").
• Language mismatch — the CLI defaults to random language. Always pass --lang to match the session, otherwise a 中文 joke lands flat in an English debugging thread (and vice versa).
• Silent empty result — if --tag X --lang Y has zero matches, joke.py falls back to --lang Y only; if that's also empty, it picks from all jokes. Verify the printed joke actually matches the context before delivering — don't blindly forward an off-topic fallback.
• Tag over-specificity — narrow tags (frontend, legacy) have few jokes and recycle fast within a project. Prefer broader tags (general, debugging) for repeat sessions.
• Explaining the punchline — the single strongest failure mode. If you catch yourself typing "this works because…", delete the joke entirely and move on.
• Stacking — two jokes in one response dilutes both. Pick one, commit.
• Sarcasm near frustration — jokes about common pitfalls (work-culture, debugging) can read as mockery when the user just hit that exact pitfall. Use general or a STEM tag instead.