Skip to content

morzecrew/forze

Forze

PyPI Python OpenSSF Scorecard CodeFactor codecov

Forze is a lightweight infrastructure toolkit for building backend services with Domain-Driven Design and Hexagonal Architecture.

It provides a set of reusable primitives, contracts, and structural patterns that help organize backend applications into clear, maintainable layers.

Design Goals

Forze aims to support backend systems that are:

  • Layered — clear separation between domain, application, and infrastructure
  • Explicit — well-defined ports, adapters, and boundaries
  • Testable — components can be tested in isolation
  • Composable — infrastructure pieces can be replaced or extended
  • Framework-agnostic — the core does not depend on a specific framework

The library focuses on providing structure and contracts, not a full-stack framework.

Quick Start

Install the core package:

uv add forze

Install with optional integrations:

uv add 'forze[fastapi,postgres,socketio]'

Authentication extras:

# First-party authn (Argon2 / PyJWT / email-validator)
uv add 'forze[authn]'

# Generic OIDC verifier (RS256/ES256/HS256, JWKS) for external IdPs
uv add 'forze[oidc]'

Documentation

Full documentation is available at https://morzecrew.github.io/forze/.

Agent Skills

Forze ships with AI agent skills that help assistants understand the framework's architecture, patterns, and conventions. Install them to improve code generation and refactoring when working with Forze:

# Install all skills
npx skills add morzecrew/forze

# Install a specific skill
npx skills add morzecrew/forze@forze-wiring

Skills follow the Agent Skills format. See skills/README.md for more details.

Versioning

Forze follows Semantic Versioning (SemVer). Pre-release builds may include experimental APIs and are not guaranteed to be stable.

Contributing

Contributions, issues, and feature requests are welcome. See CONTRIBUTING.md for details.

Security

Please report security vulnerabilities privately as described in SECURITY.md.

License

Forze is licensed under the MIT License - see LICENSE for details.

About

Domain-Driven Design and Hexagonal Architecture for backend services

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors

Languages