https://github.com/morzecrew/forze
Domain-Driven Design and Hexagonal Architecture for backend services
https://github.com/morzecrew/forze
architecture ddd domain-driven-design framework hexagonal hexagonal-architecture kernel
Last synced: 3 days ago
JSON representation
Domain-Driven Design and Hexagonal Architecture for backend services
- Host: GitHub
- URL: https://github.com/morzecrew/forze
- Owner: morzecrew
- License: mit
- Created: 2026-02-22T20:19:37.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-03T21:43:48.000Z (7 days ago)
- Last Synced: 2026-04-03T23:25:07.962Z (7 days ago)
- Topics: architecture, ddd, domain-driven-design, framework, hexagonal, hexagonal-architecture, kernel
- Language: Python
- Homepage: https://morzecrew.github.io/forze/
- Size: 3.14 MB
- Stars: 0
- Watchers: 0
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Forze
[](https://pypi.org/project/forze/)
[](https://pypi.org/project/forze/)
[](https://scorecard.dev/viewer/?uri=github.com/morzecrew/forze)
[](https://www.codefactor.io/repository/github/morzecrew/forze)
[](https://codecov.io/github/morzecrew/forze)
**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:
```bash
uv add forze
```
Install with optional integrations:
```bash
uv add 'forze[fastapi,postgres,socketio]'
```
## Documentation
Full documentation is available at [https://morzecrew.github.io/forze/](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.
Skills follow the [Agent Skills](https://agentskills.io/) format.
### Installation
```bash
# Install all skills
npx skills add morzecrew/forze
# Install a specific skill
npx skills add morzecrew/forze@forze-wiring
```
### Usage
Skills are automatically available once installed. The agent will use them when relevant tasks are detected.
### Available Skills
| Name | Description |
| -------- | -------- |
|**forze-framework-usage** | Write code that uses the framework correctly according to the core concepts. |
|**forze-domain-aggregates** | Define domain models, document aggregates, and specifications. |
|**forze-wiring** | Wire runtime, dependencies, lifecycle, usecase composition, and interface layer. |
## Versioning
Forze follows [Semantic Versioning (SemVer)](https://semver.org/).
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](https://github.com/morzecrew/forze/blob/main/CONTRIBUTING.md) for details.
## Security
Please report security vulnerabilities privately as described in [SECURITY.md](https://github.com/morzecrew/forze/blob/main/SECURITY.md).
## License
Forze is licensed under the MIT License - see [LICENSE](https://github.com/morzecrew/forze/blob/main/LICENSE) for details.