Yet another JSON library for Scala

License: Other

Language: Scala

Keywords: generic-derivation, json, scala


Build status Coverage status Gitter Maven Central

circe is a JSON library for Scala (and Scala.js).

Please see the guide for more information about why circe exists and how to use it.



Are you using circe? Please consider opening a pull request to list your organization here:

Other circe organization projects

Please get in touch on Gitter if you have a circe-related project that you'd like to discuss hosting under the circe organization on GitHub.

  • circe-benchmarks: Benchmarks for comparing the performance of circe and other JSON libraries for the JVM.
  • circe-config: A library for translating between HOCON, Java properties, and JSON documents.
  • circe-derivation: Experimental generic derivation with improved compile times.
  • circe-fs2: A library that provides streaming JSON parsing and decoding built on fs2 and Jawn.
  • circe-iteratee: A library that provides streaming JSON parsing and decoding built on and Jawn.
  • circe-jackson: A library that provides Jackson-supported parsing and printing for circe.
  • circe-spray: A library that provides JSON marshallers and unmarshallers for Spray using circe.
  • circe-yaml: A library that uses SnakeYAML to support parsing YAML 1.1 into circe's Json.

Related projects

The following open source projects are either built on circe or provide circe support:

  • Actor Messenger: A platform for instant messaging.
  • akka-http-json: A library that supports using circe for JSON marshalling and unmarshalling in Akka HTTP.
  • akka-stream-json: A library that provides JSON support for stream based applications using Jawn as a parser with a convenience example for circe.
  • Argus: Generates models and circe encoders and decoders from JSON schemas.
  • circe-kafka: Implicit conversion of Encoder and Decoder into Kafka Serializer/Deserializer/Serde
  • cornichon: A DSL for JSON API testing.
  • Cosmos: An API for DCOS services that uses circe.
  • crjdt: A conflict-free replicated JSON datatype in Scala.
  • diffson: A Scala diff / patch library for JSON.
  • elastic4s: A Scala client for Elasticsearch with circe support.
  • Enumeratum: Enumerations for Scala with circe integration.
  • Featherbed: A REST client library with circe support.
  • Finch: A library for building web services with circe support.
  • fintrospect: HTTP contracts for Finagle with circe support.
  • fluflu: A Fluentd logger.
  • Github4s: A GitHub API wrapper written in Scala.
  • content-api-models: The Guardian's Content API Thrift models.
  • http4s: A purely functional HTTP library for client and server applications.
  • IdeaLingua: Staged Interface Definition and Data Modeling Language & RPC system currently targeting Scala, Go, C# and TypeScript. Scala codegen generates models and JSON codecs using circe.
  • Iglu Schema Repository: A JSON Schema repository with circe support.
  • jsactor: An actor library for Scala.js with circe support.
  • jwt-circe: A JSON Web Token implementation with circe support.
  • kadai-log: A logging library with circe support.
  • msgpack4z-circe: A MessagePack implementation with circe support.
  • ohNoMyCirce: Friendly compile error messages for shapeless's Generic, circe's Encoder & Decoder and slick's case class mapping.
  • play-circe: circe support for Play!.
  • pulsar4s: A Scala client for Apache-Pulsar with circe support.
  • Rapture: Support for using circe's parsing and AST in Rapture JSON.
  • roc: A PostgreSQL client built on Finagle.
  • sangria-circe: circe marshalling for Sangria, a GraphQL implementation.
  • scalist: A Todoist API client.
  • scala-jsonapi: Scala support library for integrating the JSON API spec with Spray, Play! or Circe
  • scala-json-rpc: JSON-RPC 2.0 library for Scala and Scala.js
  • scalatest-json-circe: Scalatest matchers for Json with appropriate equality and descriptive error messages.
  • Scio: A Scala API for Apache Beam and Google Cloud Dataflow, uses circe for JSON IO
  • seals: Tools for schema evolution and language-integrated schemata (derives circe encoders and decoders).
  • shaclex: RDF validation using SHACL or ShEx.
  • Slick-pg: Slick extensions for PostgreSQL.
  • sttp: Scala HTTP client.
  • telepooz: A Scala wrapper for the Telegram Bot API built on circe.
  • Zenith: Functional HTTP library built on circe.


The following projects provide examples, templates, or benchmarks that include circe:

Contributors and participation

circe is a fork of Argonaut, and if you find it at all useful, you should thank Mark Hibberd, Tony Morris, Kenji Yoshida, and the rest of the Argonaut contributors.

circe is currently maintained by Travis Brown, Alexandre Archambault, and Vladimir Kostyukov. After the 1.0 release, all pull requests will require two sign-offs by a maintainer to be merged.

The circe project supports the Scala code of conduct and wants all of its channels (Gitter, GitHub, etc.) to be welcoming environments for everyone.

Please see the contributors' guide for details on how to submit a pull request.


circe is licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project Statistics

Sourcerank 17
Repository Size 7.85 MB
Stars 1,624
Forks 338
Watchers 79
Open issues 112
Dependencies 0
Contributors 186
Tags 40
Last updated
Last pushed

Top Contributors See all

Travis Brown Travis Brown Dale Wijnand Jonas Fonseca n4to4 Frank S. Thomas Olli Helenius Julien Truffaut Scala steward Howy Perrin Vladimir Kostyukov Alexey Kotlyarov Chris Birchall Alexandre Archambault pjan vandaele Alberto Paro Thuillier Benjamin Diogo Castro André L. F. Pinto Thuillier Benjamin

Packages Referencing this Repo

circe java8
Latest release 0.11.1 - Updated - 1.62K stars
circe java8
Latest release 0.11.1 - Updated - 1.62K stars
circe java8
Latest release 0.11.1 - Updated - 1.62K stars
circe java8
Latest release 0.11.1 - Updated - 1.62K stars
circe numbers testing
Latest release 0.10.0-M2 - Updated - 1.62K stars
circe scalajs
Latest release 0.6.0-RC1 - Published - 1.62K stars
circe numbers testing
Latest release 0.10.0-M1 - Updated - 1.62K stars
circe core
Latest release 0.6.0-RC1 - Published - 1.62K stars
circe core
Latest release 0.6.0-RC1 - Published - 1.62K stars
circe numbers testing
Latest release 0.9.3 - Updated - 1.62K stars
circe parse
Latest release 0.2.1 - Updated - 1.62K stars
circe literal
Latest release 0.6.0-RC1 - Published - 1.62K stars
circe optics
Latest release 0.10.0-M1 - Updated - 1.62K stars
circe shapes
Latest release 0.10.0-M2 - Updated - 1.62K stars
circe streaming
Latest release 0.9.0-M1 - Updated - 1.62K stars
circe scodec
Latest release 0.10.0-M1 - Updated - 1.62K stars
circe optics
Latest release 0.10.0-M1 - Updated - 1.62K stars
circe generic
Latest release 0.6.0-RC1 - Published - 1.62K stars
circe scodec
Latest release 0.9.3 - Updated - 1.62K stars
circe shapes
Latest release 0.9.3 - Updated - 1.62K stars

Recent Tags See all

v0.11.1 January 12, 2019
v0.11.0 December 18, 2018
v0.10.1 October 30, 2018
v0.10.0 September 24, 2018
v0.10.0-M2 August 20, 2018
v0.10.0-M1 April 24, 2018
v0.9.3 March 28, 2018
v0.9.2 March 13, 2018
v0.9.1 January 19, 2018
v0.9.0 January 01, 2018
v0.9.0-M3 December 21, 2017
v0.9.0-M2 November 01, 2017
v0.9.0-M1 August 21, 2017
v0.8.0 May 09, 2017
v0.8.0-RC1 May 01, 2017

Something wrong with this page? Make a suggestion

Last synced: 2019-03-12 22:12:21 UTC

Login to resync this repository