Skip to content
Interactive fiction (text adventure) and Mud framework
Branch: master
Clone or download
Latest commit f28fbc8 Feb 21, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
ideas renormalized line endings Nov 27, 2018
scripts fixed run script. May 28, 2017
tale version 4.6 Feb 21, 2019
.readthedocs.yml doc build Jul 2, 2017
LICENSE.txt renormalized line endings Nov 27, 2018 renormalized line endings Nov 27, 2018 release 3.6 Jul 15, 2017
mypy.ini removed the barely functional Hint / Recap system (perhaps a replacem… Jun 23, 2018
requirements.txt require serpent 1.23 Jul 3, 2017

saythanks Build Status Latest Version

Tale logo

'Tale' - mud, mudlib & interactive fiction framework

This software is copyright (c) by Irmen de Jong (

This software is released under the GNU LGPL v3 software license. This license, including disclaimer, is available in the 'LICENSE.txt' file.

Tale requires Python 3.5 or newer. (If you have an older version of Python, stick to Tale 2.8 or older, which still supports Python 2.7 as well)

Required third party libraries:

  • appdirs (to load and save games and config data in the correct folder).
  • colorama (for stylized console output)
  • serpent (to be able to create save game data from the game world)
  • smartypants (for nicely quoted string output)

Optional third party library:

  • prompt_toolkit (provides a nicer console text interface experience)

Read the documentation for more details on how to get started, see


There is a trivial example built into tale, you can start it when you have the library installed by simply typing: python -m tale.demo.story

On github and in the source distribution there are several much larger example stories and MUD examples.

  • 'circle' - MUD that interprets CircleMud's data files and builds the world from those
  • 'demo' - a random collection of stuff including a shop with some people
  • 'zed_is_me' - a small single player (interactive fiction) survival adventure

If my server is up, you can find the first two running online, see

You can’t perform that action at this time.