Tiferet – Domain-Driven Design, beautifully balanced

Tiferet is a Python framework that brings Domain-Driven Design into focus with elegance and clarity.

Inspired by the Kabbalistic principle of harmony and beauty in balance, Tiferet helps you turn complex business logic into maintainable, configuration-driven applications — where purpose, structure, and execution feel naturally aligned.

At a glance

Blueprints-first app entry point via build_app (exported as App)
Domain events as the core unit of behavior
YAML for features, workflows, dependency injection, errors, CLI commands
Clean layering: domain objects • aggregates • transfer objects • services
Structured, multilingual errors built-in
Easy to extend to CLI, web, scripts, TUI, … Current status: 2.0.0b3 (pre-release – actively evolving toward stable v2)

Quick Start – Add two numbers in ~3 minutes

# 1. Set up environment
python3 -m venv tiferet-demo && source tiferet-demo/bin/activate
pip install tiferet

Create these files in your project folder:

demo.py

from tiferet import App
app = App(
    'basic_calc',
    app_yaml_file='config.yml',
)                               # App is the build_app alias

result = app.run(
    feature_id='calc.add',
    data={'a': 19, 'b': 23},
)

print(f"19 + 23 = {result}")    # → 42

config.yml

interfaces:
  basic_calc:
    name: Basic Calculator
    description: Basic calculator interface

services:
  add_number_event:
    module_path: app.events.calc
    class_name: AddNumber

features:
  calc:
    add:
      name: Add Numbers
      commands:
        - service_id: add_number_event

app/events/calc.py
(the domain event itself – very minimal)

from tiferet.events import DomainEvent

class AddNumber(DomainEvent):
    def execute(self, a: int, b: int, **kwargs) -> int:
        return a + b

Run:

python demo.py

You should see:

19 + 23 = 42

→ Want a full calculator (add, subtract, multiply, divide, sqrt, …) with CLI, validation and proper error handling?
→ See the working example → or follow the step-by-step Tutorial →

Why Tiferet?

Configuration as code — features, DI, errors, CLI all live in YAML
Domain logic stays pure — focused events & aggregates
Infrastructure is injectable — file/db/utils behind clean service contracts
Built for evolution — today CLI, tomorrow FastAPI or TUI
Strong testability — events are easy to invoke in isolation

Documentation & Guides

Core architecture

Practical Guides

Domain Guides

Event Guides

Utility Guides

Other Component Guides

Tutorial
→ Build a complete Calculator (events + CLI + configs)

Contributing

We welcome bug reports, documentation improvements, feature ideas, and early adopters.

See CONTRIBUTING.md for the workflow (issues → TRD → feature branch → PR).

Questions, feedback, or just want to say hi?
Open an issue or reach out via email: andrew@greatstrength.me

Let's build software that feels as good as it works.

Metadata

Release files for tiferet 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tiferet 2.1.0
File	Size	Uploaded
tiferet-2.1.0.tar.gz	133.7 kB	Sep 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for tiferet 2.1.0
File	Interpreter	ABI	Platform	Reset
tiferet-2.1.0-py3-none-any.whl 178.4 kB Sep 11, 2026	Python 3	none	any	Details

Total release size: 312.1 kB

Release files / tiferet-2.1.0.tar.gz

Download URL	tiferet-2.1.0.tar.gz
Size	133.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`d18e69b676b4a71537729f9f4bb1c9ac92cc49e18ecbe2c75e9f524a8b567962`
BLAKE2b-256 checksum How to use checksums	`b7019bd42206712a0c4551649c6069404d0f49b1e583c134af4205fcf3575eaa`
Upload date	Sep 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/greatstrength/tiferet
Publishing commit: github.com/greatstrength/tiferet/tree/3d8841d93e1cae72c157d0c106e0e39160127a85

Workflow

Publishing configuration: github.com/greatstrength/tiferet/blob/3d8841d93e1cae72c157d0c106e0e39160127a85/.github/workflows/python-publish.yml
Publishing logs: github.com/greatstrength/tiferet/actions/runs/34650848814/attempts/1

Artifact

Subject: tiferet-2.1.0.tar.gz
SHA-256 checksum: d18e69b676b4a71537729f9f4bb1c9ac92cc49e18ecbe2c75e9f524a8b567962 Verifying attestations

Release files / tiferet-2.1.0-py3-none-any.whl

Download URL	tiferet-2.1.0-py3-none-any.whl
Size	178.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cdd0a475a2cc655bd931de90582ea2a22dba5a302678610fa0a41b73ca720935`
BLAKE2b-256 checksum How to use checksums	`0f10ad5b2287f0b1b5738b68d46e53cdbacde3a96433500945a06fcfc1ac97e2`
Upload date	Sep 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/greatstrength/tiferet
Publishing commit: github.com/greatstrength/tiferet/tree/3d8841d93e1cae72c157d0c106e0e39160127a85

Workflow

Publishing configuration: github.com/greatstrength/tiferet/blob/3d8841d93e1cae72c157d0c106e0e39160127a85/.github/workflows/python-publish.yml
Publishing logs: github.com/greatstrength/tiferet/actions/runs/34650848814/attempts/1

Artifact

Subject: tiferet-2.1.0-py3-none-any.whl
SHA-256 checksum: cdd0a475a2cc655bd931de90582ea2a22dba5a302678610fa0a41b73ca720935 Verifying attestations