https://github.com/formancehq/numscript

Numscript is a Domain-Specific Language (DSL) designed to help you model complex financial transactions, replacing complex and error-prone custom code with easy-to-read, declarative scripts.
https://github.com/formancehq/numscript

dsl fintech programming-language

Last synced: 12 days ago
JSON representation

Numscript is a Domain-Specific Language (DSL) designed to help you model complex financial transactions, replacing complex and error-prone custom code with easy-to-read, declarative scripts.

• Host: GitHub
• URL: https://github.com/formancehq/numscript
• Owner: formancehq
• License: mit
• Created: 2024-07-23T14:20:27.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-09-16T14:18:53.000Z (20 days ago)
• Last Synced: 2025-09-16T16:37:51.407Z (20 days ago)
• Topics: dsl, fintech, programming-language
• Language: Go
• Homepage: https://playground.numscript.org/
• Size: 950 KB
• Stars: 92
• Watchers: 4
• Forks: 5
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Numscript CLI

[![GitHub Release](https://img.shields.io/github/v/release/formancehq/numscript)](https://github.com/formancehq/numscript/releases)

[![Go Reference](https://pkg.go.dev/badge/github.com/formancehq/numscript.svg)](https://pkg.go.dev/github.com/formancehq/numscript)

[![Go](https://github.com/formancehq/numscript/actions/workflows/checks.yml/badge.svg)](https://github.com/formancehq/numscript/actions/workflows/checks.yml)

[![codecov](https://codecov.io/gh/formancehq/numscript/graph/badge.svg?token=njjqGhFQ2p)](https://codecov.io/gh/formancehq/numscript)

Numscript is the DSL used to express financial transaction within the [Formance](https://www.formance.com/) ledger.

You can try it in its [online playground](https://playground.numscript.org)

The CLI in this repo allows you to play with numscript locally, check if there are parsing or logic errors in your numscript files, and run the numscript language server

The language server features include:

- Diagnostics

- Hover on values

- Detect document symbols

- Go to definition

### Installation

You can install the `numscript` cli with one of the following ways:

**Using curl**

```sh

curl -sSf https://raw.githubusercontent.com/formancehq/numscript/main/install.sh | bash

```

**Using golang toolchain**

```sh

go install github.com/formancehq/numscript/cmd/numscript@latest

```