Skip to content

Python 3.11 or a later version

Typed, async building blocks for Python applications.

Each package does one job, and each package works alone. Put the packages together in an application, and a container connects them.

xtr

xtr is a set of Python packages for applications. Each package does one job, for example a cache, a message bus, a console or a security layer. All the packages have type annotations. Each package that does input and output has an async API.

You can use one package alone, in any Python project. You can also use the packages together in an xtr application. In an application, a container connects the packages, and each package gives a bundle that configures it.

Where to start

You want to Read
Make a new application Create an application
Add a package to an application Add a package
Learn the parts of an application The application layout
Do a specific task Guides
Find a package for a job Components
Learn how the packages connect Architecture
Find a console command Console commands

What xtr gives you

  • Packages that work alone. Each package installs with its own dependencies. A package does not need the container.
  • A container that connects the packages. The xtr-dependency-injection package builds the container from the bundles that the application lists.
  • Configuration with types. A bundle reads its configuration from a frozen dataclass. The type checker finds a wrong option before the application starts.
  • Recipes. When you add a package with xtr-recipes, its recipe writes the configuration files, the environment variables and the .gitignore lines.
  • One version for all packages. All the packages have the same version number. Two packages with the same version work together.

Requirements

  • Python 3.14.4 or a later version.
  • uv, to install the packages and to run the commands.

Source and license

The source of all the packages is in the repository. Each package has a README with its full description. The packages have the MIT license.