# cloudevents/spec

CloudEvents Specification

Repository: https://github.com/cloudevents/spec
Canonical: https://ross.abutalabs.com/products/cloudevents-spec
Homepage: https://cloudevents.io
Language: Python
License: Apache-2.0
License Family: permissive
Topics: serverless, specification
Last push: 2026-07-23T16:24:13+00:00

## Health v2 (maintenance only)
Score: 65/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 94, release rhythm 8, longevity 100
- inputs: {"age_days": 3189, "days_push": 41, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5878, forks 612 (observed 2026-08-28T04:09:31.886874+00:00)

## What it is
The CloudEvents specification, a CNCF graduated standard for describing event data in a common format so events can be interoperable across services, platforms, and systems. This repository hosts the core specification documents, protocol bindings (HTTP, AMQP, Kafka, MQTT, etc.), and event formats (JSON, AVRO, XML).

## Use cases
- standardize event payloads across microservices
- make event data portable between cloud providers
- define a common event envelope for event-driven systems
- build event routers or tracing systems that handle events uniformly
- integrate SaaS event webhooks with a consistent schema
- learn how to structure events for interoperability

## When to choose
- you are designing event-driven or serverless architectures needing vendor-neutral event formats
- you want events interoperable across cloud providers, SaaS, and on-prem systems
- you are building event routing, tracing, or middleware tooling that consumes many event sources

## When to avoid
- you need a concrete SDK implementation rather than the specification documents (use the language-specific SDK repos)
- your system is single-vendor with its own established event schema
- you need a full event broker or streaming platform rather than an event format standard

## Facets
- artifact type: learning-resource
- maturity: stable
- function: serialization, message-queue, middleware, sdk, documentation
- domain: cloud-computing, microservices, apis, developer-tools
- platform: cross-platform, cloud, serverless
- tags: cloudevents, event-driven-architecture, specification, cncf, interop, event-format, protocol-bindings, messaging

## Member repositories
- cloudevents/spec (main) score 65

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:31.886874+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:51:34.377371+00:00, confidence not recorded.
  - readme: https://github.com/cloudevents/spec (fetched 2026-08-28T04:09:31.886874+00:00, sha e1076989d58a)
  - homepage: https://cloudevents.io (fetched 2026-08-29T08:46:57.760418+00:00, sha 721e6691a308)
- Data as of 2026-08-30T08:39:29.467469+00:00.