package piqilib

  1. Overview
  2. Docs
The Piqi library -- runtime support for multi-format Protobuf/JSON/XML/Piq data serialization and conversion


Dune Dependency





Piqi is a universal schema language and a collection of tools built around it.

The Piqi language can be used to define schemas for JSON, XML, Google Protocol Buffers and some other data formats.

piqi is a command-line program that exposes some of the tools:

  • for validating, pretty-printing and converting data between JSON, XML, Protocol Buffers and Piq formats.

  • for working with the schemas, such as converting definitions between Piqi (.piqi) and Protocol Buffes (.proto), and "compiling" Piqi definitions into one of the supported portable data representation formats (JSON, XML, Protocol Buffers).

Other Piqi sub-projects include:

  • A multi-format (JSON, XML, Protocol Buffers) data serialization system for Erlang and OCaml.

  • Piq -- a human-friendly typed data representation language. It is designed to be more convenient for viewing and editing data compared to JSON, XML, CSV, S-expressions and other formats.

  • Piqi-RPC -- an RPC-over-HTTP system for Erlang. It provides a simple way to expose Erlang services via JSON, XML and Protocol Buffers over HTTP.

The Piqi project was inspired by Google Protocol Buffers and designed to be largely compatible with it. Like Protocol Buffers, Piqi relies on type definitions and supports schema evolution. The main differences is that Piqi has a richer data model, high-level modules, standard mappings to JSON and XML, and comes with a powerful data representation format (Piq). Also, Piqi is a lot more extensible.

Full project description and documentation can be found at


See INSTALL for the installation instructions.

Bug tracker

If you found a bug or have any suggestions please submit a GitHub issue:


Participation and patches are very welcome! Check TODO list for ideas.

The best way to submit a contribution is to open a pull request on GitHub against the master branch.

Mailing list

For discussions about the usage, development, and future of Piqi there is the Piqi Google Group:


Apache License Version 2.0


src/                  "piqi" command-line utility
piqilib/              common library used by piqi command-line tool and piqi-ocaml
piqi/                 Piqi self-specification
doc/                  project documentation

make/                 makefiles and build scripts
deps/                 third-party dependencies downloaded and built by `make deps`

Innovation. Community. Security.