TiddlyWeb is a Python-based WSGI application that provides:

• an HTTP API for storing and retrieving tiddlers
• an interface for persisting those tiddlers to a store
• an interface for presenting those tiddlers in various representations (e.g. HTML, JSON, plain text, TiddlyWiki, Atom)
• a rendering subsystem for turning various types of tiddlers into HTML
• entities known as bags which provide a namespace, authorization and/or topical domain for a collection of tiddlers
• entities known as recipes which assemble (and optionally filter) bags to create collections of tiddlers from multiple bags
• self-hosted authentication or pluggable integration with other auth systems

Within TiddlyWeb a tiddler is modeled as an object with:

• a title
• the bag in which it is contained
• a modifier
• a modified timestamp
• a list of tags
• a dictionary of arbitrary key value pairs
• an optional type
• a text
• a revision id

(Tiddlers do not have truly unique and persistent identifiers to keep them aligned with the ethic of naming things that comes from wiki culture. While true identifiers were mooted as a really cool things to have, it was decided not to use them as that would have distracted from the (original) purpose. It is possible now to hack such identifiers into the system if needed.)

If a tiddler has no type it is assumed to be aligned with TiddlyWiki's notion of a tiddler: a block of text, most likely in TiddlyWiki syntax or a JavaScript plugin for use in TiddlyWiki. Otherwise type is a MIME type. With textual types {{{text}}} is a unicode string, otherwise bytes.

//A tiddler is a revisioned web resource with some useful metadata. A tiddler is agnostic with regard to content.//