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.1.1 Unit tests use @use_tester — see Testing Harness.

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.2.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.2.0
File	Size	Uploaded	Provenance
tiferet-2.2.0.tar.gz	211.3 kB	Oct 17, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for tiferet 2.2.0
File	Interpreter	ABI	Platform	Reset
tiferet-2.2.0-py3-none-any.whl 261.0 kB Oct 17, 2026 With provenance	Python 3	none	any	Details

Total release size: 472.3 kB

Release files / tiferet-2.2.0.tar.gz

Download URL	tiferet-2.2.0.tar.gz
Size	211.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`023c21a278e527c368dfe386e5513c17b59aa6153ce08204affe10b9914d8a06`
BLAKE2b-256 checksum How to use checksums	`18d1ba07d16c83e615db17c8444038fb079773ab771520fa5a69efa01694491c`
Upload date	Oct 17, 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/c6ec5c5a225f81c7d611d9395cad51fac4b62b19

Workflow

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

Artifact

Subject: tiferet-2.2.0.tar.gz
SHA-256 checksum: 023c21a278e527c368dfe386e5513c17b59aa6153ce08204affe10b9914d8a06 Verifying attestations

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

Download URL	tiferet-2.2.0-py3-none-any.whl
Size	261.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`01a139fec54f8ea70fbaff5d85c6bd58e9e383e1d0e817ef0b7b772e693f6476`
BLAKE2b-256 checksum How to use checksums	`8dd3c1ca2ec96b001610c7e93d3cae4f2ad45f3431983d9c1105037ecb42aa0a`
Upload date	Oct 17, 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/c6ec5c5a225f81c7d611d9395cad51fac4b62b19

Workflow

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

Artifact

Subject: tiferet-2.2.0-py3-none-any.whl
SHA-256 checksum: 01a139fec54f8ea70fbaff5d85c6bd58e9e383e1d0e817ef0b7b772e693f6476 Verifying attestations

Security for tiferet 2.2.0

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for tiferet-2.2.0.tar.gz

Identity

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

Workflow

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

Artifact

Subject: tiferet-2.2.0.tar.gz
SHA-256 checksum: 023c21a278e527c368dfe386e5513c17b59aa6153ce08204affe10b9914d8a06 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.