Payroll Engine
The open-source payroll automation framework.
Build multi-country, multi-industry payroll applications with composable regulation layers.
Website · Get Started · Quick Start · Discussions
The Payroll Engine is a framework for building payroll applications. Payroll logic lives in configurable regulation layers — not hardcoded. Layers are stacked, overridden, and shared across tenants, countries, and industries.
Embed it via REST API, deploy it via Docker, or automate it with the .NET Client SDK.
| Role | Who | Interface |
|---|---|---|
| Provider | HR-tech platforms, EOR providers | REST API · OpenAPI 3.1 |
| Regulator | Payroll consultants, HR specialists | No-Code Actions · C# Scripting |
| Automator | DevOps, integration engineers | .NET Client Services SDK · CLI |
# 1. Login to GitHub Container Registry (one-time)
echo "<your-pat>" | docker login ghcr.io -u <github-username> --password-stdin
# 2. Clone and configure
git clone https://github.com/Payroll-Engine/PayrollEngine.git
cd PayrollEngine
echo "DB_PASSWORD=PayrollStrongPass789" > .env
# 3. Start
docker compose -f docker-compose.ghcr.yml up -dWeb Application: http://localhost:8081 · Backend API: http://localhost:5001
| Repository | Description |
|---|---|
| PayrollEngine | Main repo — Docker stack, examples, tests, schemas |
| PayrollEngine.Backend | REST API server + SQL Server persistence |
| PayrollEngine.WebApp | Blazor web application |
| PayrollEngine.PayrollConsole | CLI for automation, testing, and data import |
| PayrollEngine.Client.Services | .NET Client SDK (NuGet entry package) |
| PayrollEngine.Client.Scripting | Scripting API for regulation development |
| PayrollEngine.Client.Core | Client core objects |
| PayrollEngine.Client.Test | Test runner library |
| PayrollEngine.Core | Core payroll objects |
| PayrollEngine.Document | Report generation |
| PayrollEngine.Serilog | Structured logging |
MIT — free for any use. See LICENSE.
Pinned Loading
Repositories
- PayrollEngine Public
Open-source framework for regulation-driven payroll applications — multi-tenant, multi-country, API-first, with No-Code/Low-Code automation and test-driven development.
- PayrollEngine.Mcp.Server Public
MCP Server for the Payroll Engine — enables AI agents to query and analyse payroll data using natural language.
- PayrollEngine.PayrollConsole Public
CLI tool for the Payroll Engine — import/export payroll data (JSON/YAML), run payruns, execute payroll tests, and automate workflows via .pecmd command files.
- PayrollEngine.WebApp Public
Blazor Server web application for the Payroll Engine — payroll management, employee self-service, case data entry, forecasting, and reporting. Docker-ready.
- PayrollEngine.Backend Public
REST API backend server for the Payroll Engine — regulation execution, payrun processing, multi-tenant data management, and SQL Server persistence. Docker-ready.
- PayrollEngine.AiContext Public
Structured LLM context for MCP Server access and REST API integration with Payroll Engine.
- PayrollEngine.Template.Regulation.Country Public template
Payroll Engine country regulation template — NuGet packaging, CI/CD workflows, and regulation skeleton for building statutory payroll regulations
- PayrollEngine.Mcp.Tools Public
Read-only MCP tools for the Payroll Engine — HR, Payroll, Report and System query tools built on PayrollEngine.Mcp.Core, ready for use in any MCP server deployment.
- PayrollEngine.Mcp.Core Public
Core infrastructure for Payroll Engine MCP servers — isolation contexts, permissions, tool registration and base classes for building read and write MCP tool libraries.
- PayrollEngine.Client.Services Public
NuGet entry package for .NET integration with the Payroll Engine — bundles Client.Core and Client.Scripting with function controllers, payroll period implementations, and the script execution context.
People
This organization has no public members. You must be a member to see who’s a part of this organization.
Top languages
Loading…
Most used topics
Loading…