WunderGraph is a free, open source api development & testing project written in TypeScript and released under Apache-2.0. It has 1,265 GitHub stars, 252 forks and 124 open issues, and was last pushed 8 hours ago. On this registry it ranks #86 of 103 tracked projects in API Development & Testing, with 5 head-to-head comparisons available. It gained 2 stars over the last 6 tracked days.

What is WunderGraph?

What it is

WunderGraph Cosmo is an open-source lifecycle API management platform for federated GraphQL. It lives in the GraphQL ecosystem, and its GitHub description identifies it as an alternative to Apollo Studio and GraphOS. The project is written in TypeScript and released under the Apache-2.0 license.

The problem it addresses is combining many GraphQL services into one graph. Federation lets separate teams maintain smaller schemas, and those schemas are combined into one graph. Cosmo supports both monolithic and federated architectures, so teams can use it while they move from a single schema to a distributed model. It also provides routing, schema registry, composition checks, analytics, metrics, and tracing for that combined graph.

Key capabilities

  • It provides a schema registry for federated GraphQL schemas, so teams can manage the graph over time.
  • It runs composition checks, which help validate that multiple service schemas can be combined into a usable federated graph.
  • It includes a GraphQL router, listed in the topics as graphql-router, for serving the combined API surface.
  • It provides analytics, metrics, and tracing for the federated graph.
  • It supports both monolithic and federated architectures, according to the README overview.
  • It can be deployed entirely on-premises or used through a managed service, without vendor lock-in under the Apache-2.0 license.
  • It provides examples for local composition, Docker Compose evaluation, and Kubernetes deployment through an official Helm Chart.

Who uses it and how

  • Developers use it to compose a federated GraphQL schema locally from multiple services and run the Cosmo Router.
  • Architects use it to evaluate the entire Cosmo Platform for an organization by running it locally with Docker Compose.
  • Platform engineers use it to deploy the full platform to Kubernetes through the official Helm Chart.
  • Teams use it when they need a shared GraphQL surface across services, because the README describes federation as a way to combine schemas maintained by different teams.
  • Organizations considering Apollo Studio or GraphOS use it as an open-source alternative under Apache-2.0, with either self-hosting or a managed service.

Getting started

The README directs users to clone https://github.com/wundergraph/cosmo.git, choose an example, and follow the linked instructions. It also mentions a managed service at https://cosmo.wundergraph.com/login, Docker Compose for local evaluation, and an official Helm Chart for Kubernetes deployment.

When to use it — and when not to

WunderGraph Cosmo is a good fit when a team wants an open-source alternative to Apollo Studio and GraphOS for federated GraphQL, especially if it needs self-hosting or wants to avoid vendor lock-in. It is less suitable for teams that do not want to evaluate self-hosted deployment paths, because the README documents Docker Compose and Kubernetes Helm Chart deployment. The listing also shows 124 open issues and zero contributors, so teams should inspect those facts before adoption.

project readme (upstream, from github) — read inline

WunderGraph Cosmo - The GraphQL Federation Platform
Reach for the stars, ignite your cosmo!

Quickstart · Examples · Docs · CLI · Community · Changelog · Hiring

Open Source AI Manifesto

Overview

WunderGraph Cosmo is a comprehensive Lifecycle API Management platform tailored for Federated GraphQL. It encompasses everything from Schema Registry, composition checks, and analytics, to metrics, tracing, and routing. Whether you’re looking to deploy 100% on-prem or prefer a Managed Service, Cosmo offers flexibility without vendor lock-in, all under the Apache 2.0 license.

The State of GraphQL Federation 2024

Get insights from industry experts and Federation practitioners across all industries and learn how companies are using GraphQL Federation. Head over to the State of GraphQL Federation 2024 page and download the full 48-page PDF report for free!

Why Federated GraphQL?

GraphQL Federation empowers organizations to break down their GraphQL schema into multiple smaller, manageable schemas, each maintained by different teams or services. These individual schemas are then combined into a single, unified graph, ensuring that all teams have consistent access to the data they need. In today's data-driven world, where information is often referred to as the new oil, building a unified API that can be consumed by both internal and external teams is more crucial than ever.

Not all companies start with a federated architecture, Cosmo supports both monolithic and federated architectures.

Getting Started

To get started with WunderGraph Cosmo, follow these steps:

  1. Clone the Repository: git clone https://github.com/wundergraph/cosmo.git
  2. Choose your Example: Select the example that best fits your role and use case from the Try Cosmo Now section and follow the instructions.
  3. Explore Further: Check out the Docs for more information on Cosmo's features and capabilities.

Try Cosmo Now! :rocket:

Get started with Cosmo by choosing the example that best fits your role and use case:

  • Developer: Quickly start with Cosmo by composing a federated GraphQL schema locally from multiple services and running the Cosmo Router.
  • Architect: Evaluate the entire Cosmo Platform for your organization by running it locally with Docker Compose.
  • Platform Engineer: Deploy the entire Cosmo Platform to Kubernetes through our official Helm Chart.
  • Decision Maker (e.g. Engineering Manager, CTO): Get in touch with the founders to discuss how Cosmo can help your organization.

Local Development

To contribute to this repo and get the local environment up and running, please refer to CONTRIBUTING.md

For any questions, feedback, or support, please contact us.


From the WunderGraph Blog

Here's a selection of blog posts that focus on the technical aspects of Cosmo:

Contributing

We welcome contributions from the community! Whether it's fixing a bug, adding new features, or improving documentation, your help is greatly appreciated. Please take a look in our Contributing Guide to get started.

License

Cosmo is licensed under the Apache License, Version 2.0.

Frequently asked questions

Is WunderGraph free to use?

WunderGraph is open source under the Apache-2.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does WunderGraph do?

Unify APIs, databases, and services effortlessly

What is WunderGraph written in?

WunderGraph is primarily written in TypeScript. Its source is publicly available at https://github.com/wundergraph/cosmo, and it has 1,265 GitHub stars.