How to play
Someone picks a screenshot (their own, or one Nani Pix finds on Shikimori,
Tenrai or TMDB) and tells her which anime it is. She posts it heavily
pixelated in your group's game topic, and everyone races to /guess the
title. The picture gets sharper as wrong guesses pile up, over five stages,
until someone gets it or she reveals the answer.
Features
- 🎯 Forgiving guesses: case, punctuation, season numbers and small typos don't matter, and alternative titles count
- 🎬 Animated reveal: the picture sharpens into a short video that ends with the winner's badge
- 💠 Currency and clue shop: earn pixels for playing, spend them on a letter, the title's shape or an extra screenshot
- 🔥 HARD MODE: games Nani Pix starts herself show two screenshots at once
- 🏆 Achievements and champions: titles to unlock, weekly, monthly and yearly winners
- 📊 Leaderboards, history and profiles for every player
- 🌐 English and Russian
- …and many more, see the guide
Self-hosting
Nani Pix runs as a Docker Compose stack. The
self-hosting guide
walks you through every step, from creating your Telegram bot to updating
her.
Development
You need uv, mise and
Docker.
git clone https://github.com/sm-steel/nani-pix-bot && cd nani-pix-bot
mise install # pinned uv, qlty, ffmpeg and Node
uv sync
uv run pre-commit install
uv run pytest
To run your own Nani Pix, create a test bot with
@BotFather, then cp .env.example .env, fill it in
and run docker compose up --build. The game rules are in
MECHANICS.md, the code's layout in
ARCHITECTURE.md, and the conventions in
CLAUDE.md.
License
MIT, the Nani Pix artwork included.
