Concerto

A lightweight schema language and runtime for business concepts.

concept Person identified by name  {
  o String name
  o Address address optional
  @description("Height (cm)")
  o Double height range=[0,]
  o DateTime dateOfBirth 
}

🏢 Concerto gives you “just enough” expressivity to capture real-world business models, while remaining easy to map to most runtime environments.

⛳ An object-oriented language that is much easier to read and write than JSON/XML Schema, XMI or equivalents.

📄 Serialize your instances to JSON

🍪 Deserialize (and validate) instances from JSON

🔎 Introspect the model using a powerful set of APIs

🎛 Convert the model to other formats:

JSON Schema
XML Schema
OData CDSL
GraphQL Schema
Java Classes
Go Types
C# Classes
TypeScript Classes
Protobuf Messages
PlantUML Diagrams
Mermaid UML Diagrams
Markdown (with embedded Mermaid)
OpenAPI v3 specification document
Apache Avro

🕸 Publish your reusable models to any website, including the Accord Project model repository

Infer models from other formats:

JSON document
JSON Schema
OpenAPI v3 specification document

Getting Started

Install the Command Line Tool
Read the Concerto specification

$ npm i -g @accordproject/concerto-cli
$ concerto compare --old model.cto --new model-with-changes.cto 
[required-field-added]: The required field "weight" was added to the concept "Person" (major)

Open VSCode (on the web, on your machine)

VSCode Editor

Add to your Node.js project
Add to your .NET project

Structure of the Code

Top level repository (concerto), with sub packages. Each sub-package is published as an independent npm module using lerna:

concerto-core : core library for model management/parsing/validation/serialization
concerto-util : contains utility functions used in other parts of the code and fundamentally independent from Concerto as a modeling language
concerto-cto : contains the parser for the .cto syntax for Concerto. The parser now outputs a proper Concerto object, instance of the metamodel rather than a custom JSON object.
concerto-vocabulary : functionality to handle model vocabularies and localization
concerto-analysis : tools for comparing model files
concerto-types : TypeScript type definitions for Concerto
concerto-dotnet : .NET type definitions for Concerto, and serialization tools

Accord Project is an open source, non-profit, initiative working to transform contract management and contract automation by digitizing contracts. Accord Project operates under the umbrella of the Linux Foundation. The technical charter for the Accord Project can be found here.

Learn More About Accord Project

Overview

Documentation

Contributing

The Accord Project technology is being developed as open source. All the software packages are being actively maintained on GitHub and we encourage organizations and individuals to contribute requirements, documentation, issues, new templates, and code.

Find out what’s coming on our blog.

Join the Accord Project Technology Working Group Discord Community to get involved!

For code contributions, read our CONTRIBUTING guide and information for DEVELOPERS.

README Badge

Using Accord Project? Add a README badge to let everyone know:

[![accord project](https://img.shields.io/badge/powered%20by-accord%20project-19C6C8.svg)](https://www.accordproject.org/)

License

Accord Project source code files are made available under the Apache License, Version 2.0. Accord Project documentation files are made available under the Creative Commons Attribution 4.0 International License (CC-BY-4.0).

accordproject / concerto

readme