ghostdogpr /caliban

Functional GraphQL library for Scala

★ 994⑂ 261👁 19⑃ 2,790● 435▤ 93
ScalaApache-2.0Created 2019-09-12ghostdogpr.github.io/caliban/
Download: v3.2.1v3.2.1 ↓3.2.12026-11-06
+0
Daily
994
stars
261
forks
19
watchers
2,790
prs
435
issues
93
releases

README

Caliban

[![Release Artifacts][Badge-SonatypeReleases]][Link-SonatypeReleases]
[![Badge-Discord]][Link-Discord]

[Link-SonatypeReleases]: https://central.sonatype.com/artifact/com.github.ghostdogpr/caliban_3 "Sonatype Releases"
[Badge-SonatypeReleases]: https://img.shields.io/maven-central/v/com.github.ghostdogpr/caliban_3 "Sonatype Releases"
[Link-Discord]: https://discord.gg/2ccFBr4 "Discord"
[Badge-Discord]: https://img.shields.io/discord/629491597070827530?logo=discord "chat on discord"

Caliban is a purely functional library for building GraphQL servers and clients in Scala.
 
The design principles behind the library are the following:
- minimal amount of boilerplate: no need to manually define a schema for every type in your API.
- high performance: while every public interface is pure and immutable, library internals have been optimized for speed.
- clean separation between schema definition and implementation: schema is defined and validated at compile time using Scala standard types, resolver (RootResolver) is a simple value provided at runtime.

 Consult the Documentation to learn how to use Caliban.

 Any questions? Head up to the caliban channel on ZIO Discord.

 Adopters

Here is a partial list of companies using Caliban in production.

Want to see your company here? Submit a PR!

 Anduin Transactions
 AnyMind Group
 AutoScout24
 BusinessChat.io
 Carvana
 Conduktor
 Credimi
 Devsisters
 Fugo.ai
 LeadIQ
 Norwegian Agency for Shared Services in Education and Research
 Sanjagh.pro
 Soundtrack Your Brand
 StepZen
 Undo
 Valamis Group

Top issues

Latest release

v3.2.1 v3.2.1 2026-11-06
Release Notes

This release adds @defer support to Caliban Gateway and fixes queries with repeated fragment spreads taking exponential time to process. It also includes a few bug fixes and forks fewer fibers per gateway request.

 New Features
 Added @defer support to the gateway, enabled by default and using the deferSpec=20220824 format, by @ghostdogpr in https://github.com/ghostdogpr/caliban/pull/3160

 Bug Fixes
 Fixed exponential processing of queries that spread the same fragments several times at each level, in maxDepth, maxFields, cost estimation, cache control and the gateway,

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON