Clonenames

Play a Codenames-style game online with anyone you want.

Clonenames is a clone of the game Codenames (site, wiki) written in Python using Flask and Socket.IO.

Clonenames will let you play across the internet, by connecting to a specific room code, so you can "remotely". The game uses WebSockets to allow the "hosts" to update the screens of the "players".

Unlike the original game, Clonenames allows up to 4 teams, and game boards with up to 100 words (10x10). Additionally, you can play using different word lists for a different challenge! Word lists include:

• The Original Codenames Words
• Cards Against Humanity
• Gen. 1 Pokemon
• PYTHON3 BUILTINS!!!

And it's very easy to add any other word lists. They're just new-line delineated files.

Getting Started

Prerequisites/Required Libraries

flask>=3.1.1
flask-socketio>=5.5.1
eventlet>=0.40.0

Clone or download this repository, and install the dependencies.

git clone https://github.com/cazier/clonenames.git
cd clonenames

You can start it directly using uv with:

$ uv run python clonenames/web.py

Or create and activate a virtual environment with:

$ uv venv
$ source venv/bin/activate
(venv) $ python web.py

Play!

Open a web browser to 127.0.0.1:5000 and you can start a game!

Deployment

Please refer to DEPLOYMENT for an (extremely) rough intro on how to deploy this on a webserver.

Gameplay

The rules are very simple. There needs to be one Host and at least one Player for each team. The Host can see which words are theirs based off of color. Then try to get your players to guess your words (and your words only!) with a single clue, and a number of words:

• For example, with a clue like "typecasting, 4" I would probably guess str, int, float, bytes depending on what's actually visible on the board.

Try to get your team to guess all of the words in your color, without guessing any of the other team's words, or those of the Bystanders. Either will end your turn, and will reveal the color of the other team. Especially, be wary not to guess the Assassin, as that will end the game with your defeat!

Built With

• Flask
• Socket.IO
• Flask-SocketIO
• Bootstrap

Authors

• Brendan Cazier - Initial work- cazier

License

This project is licensed under the GPLv3 License - See LICENSE for more details.

Acknowledgements

• Obviously Czech Games for the original game idea
• u/professorfart7933 for suggesting the name "Clonenames"!