Repolode
formancehq

formancehq/stack

Open-source developer platform for building and operating money flows, including a double-entry ledger, payments layer and Numscript DSL.

Stars
529
Forks
71
Open issues
1
Last commit
26 days ago

What is it?

Formance Stack is a modular platform for building and running financial money flows of any size. It can be deployed as a whole or its components can be used separately as micro-services and libraries.

The main components are Formance Ledger, a programmable double-entry, immutable record of internal financial transactions and money movements; Formance Payments, a unified API and data layer for payments processing; and Formance Numscript, a DSL and virtual machine for describing monetary computations and transactions.

The services are distributed as binaries with optional Docker images, configurable through command-line options and environment variables. The recommended deployment target is Kubernetes using official Helm charts. The stack uses PostgreSQL for storage, Kafka or NATS for asynchronous communication between services, and Traefik as the HTTP gateway.

Key features

  • 01Double-entry, immutable ledger for recording money movements
  • 02Unified API and data layer for payments processing
  • 03Numscript DSL and virtual machine for transaction modeling
  • 04Standalone micro-services and libraries or full-stack deployment
  • 05Official Helm charts for Kubernetes deployment

Use cases

  • Building internal ledgers for fintech or wallet products
  • Unifying payment provider integrations behind a single API
  • Defining monetary transaction logic in code with Numscript

Quick start

  1. 1

    Tap the Formance Homebrew repository (macOS)

    brew tap formancehq/tap
  2. 2

    Install the Formance CLI (fctl)

    brew install fctl
  3. 3

    Log in to Formance Cloud

    fctl login
  4. 4

    Create a sandbox stack deployment for testing

    fctl stack create foobar

Things to know

  • The Cloud sandbox is for testing only and is not meant for production use.
  • The metadata gives no clear license identifier, so check the repository's license terms before use.
  • The quick start shown uses Homebrew, so it targets macOS.

Topics

FAQ

What is stack?
Open-source developer platform for building and operating money flows, including a double-entry ledger, payments layer and Numscript DSL. Formance Stack is a modular platform for building and running financial money flows of any size. It can be deployed as a whole or its components can be used separately as micro-services and libraries.
Is stack free to use? What license does it have?
stack is open source under the Other license. Check the license terms before using it in commercial products.
Is stack still maintained?
Actively maintained. The last commit to stack was on Sep 25, 2026.
What can I use stack for?
Building internal ledgers for fintech or wallet products Unifying payment provider integrations behind a single API Defining monetary transaction logic in code with Numscript
How do I install stack?
Tap the Formance Homebrew repository (macOS): brew tap formancehq/tap Install the Formance CLI (fctl): brew install fctl Log in to Formance Cloud: fctl login Create a sandbox stack deployment for testing: fctl stack create foobar
Where can I get stack?
The source code and installation instructions are on GitHub: https://github.com/formancehq/stack

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects