v1.76.0

Compare Source

This is release 1.76.0 (genuine) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• Prioritize system CA over bundled CA. (#​40583)
• [event_engine] Introduce a event_engine_poller_for_python experiment. (#​40243)
• [metrics] add grpc.lb.backend_service label. (#​40486)

C#

• [csharp tools] #​39374 Grpc.Tools can't process file Suffix name with Upper character. (#​40072)

Python

• [Python] gRPC AsyncIO: Improve CompletionQueue polling performance. (#​39993)

v1.75.1

Compare Source

This is release gRPC Core 1.75.1 (gemini).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

What's Changed

Python

• Release grpcio wheels with Python 3.14 support (#​40403)
• Asyncio: fixes grpc shutdown race condition occurring during python interpreter finalizations. (#​40447)
  • This also addresses previously reported issues with empty error message on Python interpreter exit (Error in sys.excepthook:/Original exception was: empty): #​36655, #​38679, #​33342
• Python 3.14: preserve current behavior when using grpc.aio async methods outside of a running event loop. (#​40750)
  • Note: using async methods outside of a running event loop is discouraged by Python, and will be deprecated in future gRPC releases. Please use the asyncio.run() function (or asyncio.Runner for custom loop factories). For interactive mode, use dedicated asyncio REPL: python -m asyncio.

Full Changelog: grpc/grpc@v1.75.0...v1.75.1

v1.75.0

Compare Source

This is release 1.75.0 (gemini) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [Security] Cherry Pick Spiffe Verification. (#​40515)
• [Python][Typeguard] Part 3 - Add Typeguard to AIO stack in tests. (#​40217)
• [c-ares] update version to 1.34.5. (#​39508)
• [pick_first] fix bug that caused us to stop attempting to connect. (#​40162)

C++

• [OTel C++] Implement retry metrics. (#​39195)

Objective-C

• Fix data race by adding custom getter for state property with @synchronized locking. (#​40146)

Python

• gRPC Python (grpcio) now depends on typing-extensions~=4.13. (#​40137)
• Update musllinux wheels from musllinux_1_1 to musllinux_1_2. (#​40317)
  • Dropping musllinux_1_1 because it reached EOL in November 2024
  • Reference on musllinux platform tags: PEP 656
• grpc.aio typehint fixes. (#​40215, #​40217)
  • Metadata type validation: Fixed metadata handling to support all sequence types (not just tuples), preventing runtime errors. Enhanced metadata type validation: isinstance(metadata, Sequence) instead of isinstance(metadata, tuple)
  • Serializer parameters: Changed to Optional[SerializingFunction] for more accurate type representation
  • Fixing the error in public API: ClientCallDetails.method was declared as str but always called with bytes, see InterceptedUnaryUnaryCall.
• Fixes issue #​40325 with grpcio failing to install on all non-Mac Apple devices internal builds. (#​40347)

Ruby

• Ruby: Mark credential object in channel. (#​40394)
• [Ruby] Add rubygems support for linux-gnu and linux-musl platforms. (#​39549)

v1.74.0

Compare Source

This is release 1.74.0 (gee) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [OTel C++, Posix EE] Plumb TCP write timestamps and metrics to OTel tracers. (#​39946)
• [event_engine] Implement fork support in Posix Event Engine. (#​38980)
• [http2] Fix GRPC_ARG_HTTP2_STREAM_LOOKAHEAD_BYTES for when BDP is disabled. (#​39585)

Objective-C

• [dep] Upgrade Protobuf Version 31.1. (#​39916)

PHP

• [PHP] Fully qualify stdClass with global namespace. (#​39996)
• [php] Fix PHPDoc so that UnaryCall defines the proper return type. (#​37563)
• fix typing of nullable parameters. (#​39199)

Python

• [EventEngine] Fix the issue with gRPC Python Client not reconnecting in certain situations: #​38290, #​39113, #​39631. (#​39894)
• Fix gRPC Python docs website layout - use spaces optimally. (#​40073)

Ruby

• [Ruby] Add rubygems support for linux-gnu and linux-musl platforms . (#​40174)
• [ruby] enable EE fork support. (#​39786)
• [ruby] Return nil for c functions expected to return a VALUE. (#​39214)
• [ruby] remove connectivity state watch thread, fix cancellations from spurious signals. (#​39409)
• [ruby] Drop Ruby 3.0 support. (#​39607)

v1.73.1

Compare Source

This is release 1.73.1 (gradient) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Python

• [Backport of #​39894 to v1.73.x] Fix the issue with gRPC Python Client not reconnecting in certain situations: #​38290, #​39113, #​39631 (#​39950).

v1.73.0

Compare Source

This is release 1.73.0 (gradient) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

As of this version, gRPC on MacOS & iOS will utilize Abseil's synchronization features, aligning it with other platforms. Should you encounter any issues due to this update, you can disable it by enabling GPR_DISABLE_ABSEIL_SYNC. If you do this, please report any problems by filing a bug at https://github.com/grpc/grpc.

• [Dep] Update Protobuf to v31.0. (#​39392)
• [Core] Added GPR_DISABLE_ABSEIL_SYNC. (#​39562)
• [xds_override_host] pass through per-endpoint args when creating subchannels. (#​39532)
• Expose GRPC_OPENSSL_CLEANUP_TIMEOUT to control shutdown grace period. (#​39297)
• [URI] fix parsing of user_info in proxy settings. (#​39004)
• [EventEngine] Fix busy loop in thread pool when shutting down. (#​39258)
• [Dep] Added a flag to build with openssl instead of boringssl. (#​39188)
• [EventEngine] Cleanup: EventEngine client, listener, and dns experiments are on by default on all platforms. (#​39079)

C++

• [OpenCensus] Mark OpenCensus and dependent APIs as deprecated. (#​39554)

Python

• [Python] Pin Cython to 3.1.1. (#​39609)
• [Python] grpc_tools: make PythonGrpcGenerator handle dot . in proto paths the same way as native Generator/PyiGenerator. (#​39586)

Ruby

• [Ruby] add remove_unused_artifacts to opt build. (#​39593)

v1.72.2

Compare Source

This is release 1.72.2 (gusto) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Python

• [Backport of #​39894 to v1.72.x] Fix the issue with gRPC Python Client not reconnecting in certain situations: #​38290, #​39113, #​39631. (#​39949)

v1.72.1

Compare Source

This is release gRPC Core 1.72.1 (gusto).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

C++

• [Backport of #​39266 to v1.71.x] Protect grpc generated sources from unwanted system macros (#​39484).

Python

• [Backport of #​39609 to v1.71.x] Pin Cython to 3.1.1 (#​39632). This addresses several issues:
  • #​39588 Using inconsistent Cython version in released platform-specific wheels within the same grpcio release.
  • cython/cython#6878 Several published grpcio wheels were built with Cython 3.1.0 and are affected by Cython memory leak issue when using AsyncIO APIs (grpc.aio.*).
• [Backport of #​39418 to v1.71.x] Fix Python 3.12 MacOS universal release artifact (#​39504).

v1.72.0

Compare Source

This is release gRPC Core 1.72.0 (gusto).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

v1.71.2

Compare Source

This is release 1.71.2 (gears) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

C++

• [Backport of #​39266 to v1.71.x] Protect grpc generated sources from unwanted system macros (#​39484).

Python

• [Backport of #​39894 to v1.71.x] Fix the issue with gRPC Python Client not reconnecting in certain situations: #​38290, #​39113, #​39631 (#​39948).
• [Backport of #​39609 to v1.71.x] Pin Cython to 3.1.1 (#​39636). This addresses several issues:
  • #​39588 Using inconsistent Cython version in released platform-specific wheels within the same grpcio release.
  • cython/cython#6878 Several published grpcio wheels were built with Cython 3.1.0 and are affected by Cython memory leak issue when using AsyncIO APIs (grpc.aio.*).

v1.71.0

Compare Source

This is release gRPC Core 1.71.0 (gears).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

Core

• [CallAttemptTracer] Fix call attempt tracer lifetimes for retries (#​38729). (#​38796)
• [pick_first] fix bug that caused us to stop triggering connection attempts. (#​38714)
• [CodeGen][CPP] Added support for service "deprecated" option. (#​38493)
• [EventEngine] Add SetDefaultEventEngine API (and friends). (#​38316)

C++

• [build] Restrict grpc++_public_hdrs target to internal visibility. (#​38646)
• [Doc] Added C++17 cmake option. (#​38432)

Python

• [CI] Drop Python 3.8. (#​38747)
• [Python] Support musl-linux binary wheels on arm64. (#​38223)

Ruby

• [ruby] Build/test ruby 3.4 and build native gems with Ruby 3.4 support. (#​38338)

v1.70.0

Compare Source

This is release 1.70.0 (genius) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [BoringSSL] Update third_party/boringssl-with-bazel. (#​38274)

C++

• gRPC C++ begins to require C++17 or later to build and use gRPC C++. You may need the following settings:
  • CMake: Add CMAKE_CXX_STANDARD=17 to your CMake build command.
  • Bazel: Add --cxxopt='/std:c++17' and --host_cxxopt='/std:c++17' to your Bazel build command.
  • gRPC 1.69, the final version compatible with C++14, will be supported until December 10, 2025, according to https://github.com/grpc/proposal/blob/master/L120-requiring-cpp17.md.

Python

Added 2025-06-27:
CAUTION! This release contains a known defect in gRPC Python client reconnection logic (#​38290), which was fixed in v1.71.2, v1.72.2, v1.73.1, and all subsequent releases. We recommend upgrading.

v1.69.0

Compare Source

This is release 1.69.0 (gridiron) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [Alarm] Fix Alarm reuse on cancellation. (#​38114)
• [xDS RBAC] Support string_match in HeaderMatcher. (#​38185)
• [pick_first] fix shutdown bug in new PF impl. (#​38144)
• [c-ares] Fix inverted length check in GrpcPolledFdWindows. (#​38101)
• [RetryFilter] Copy the SliceBuffer from RetryFilter's cache to batch payload. (#​38069)
• [EventEngine] Add stronger wording on Endpoint::Read contract. (#​38036)
• [chttp2] Fix channelz address. (#​38022)
• [XdsClient] Add missing authority to XdsClient metrics scope. (#​38009)
• [EventEngine] API contract: Endpoint::Read will provide either an error or data, but never both. (#​38019)
• [Build] Dropped Bazel 6.x support. (#​37979)

Python

Added 2025-06-27:
CAUTION! This release contains a known defect in gRPC Python client reconnection logic (#​38290), which was fixed in v1.71.2, v1.72.2, v1.73.1, and all subsequent releases. We recommend upgrading.

• [Build] Override MACOSX_DEPLOYMENT_TARGET for gRPC Python. (#​37997)

v1.68.1

Compare Source

This is release 1.68.1 (groovy) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [xDS RBAC] Support string_match in HeaderMatcher (#​38185). (#​38198)

Python

Added 2025-06-27:
CAUTION! This release contains a known defect in gRPC Python client reconnection logic (#​38290), which was fixed in v1.71.2, v1.72.2, v1.73.1, and all subsequent releases. We recommend upgrading.

v1.68.0

Compare Source

This is release 1.68.0 (groovy) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [XdsClient][Backport] Add missing authority to XdsClient metrics scope (#​38009). (#​38023)
• [Release] Bump core version in preparation for 1.68 Branch Cut. (#​37941)
• [ConfigFetcher] Set HTTP2 error to NO_ERROR to do graceful GOAWAYs. (#​37939)
• [ruby] reduce INFO log for server CQ pluck registration to DEBUG. (#​37633)
• [EventEngine] Enable the PosixEventEngine client experiment. (#​35985)
• [chttp2_server] Fix race between connection starting and it being orphaned. (#​37683)
• [Chttp2Server] Fix race between connection manager updates and handshake. (#​37772)
• [xds] Fix XdsClient race between ResourceDoesNotExist timer and receiving resources. (#​37678)

C++

• [Build] Minimum version of MSVC is now 2022. (#​37687)
• [Build] Bumped the minimum version of cmake. (#​37702)

Python

Added 2025-06-27:
CAUTION! This release contains a known defect in gRPC Python client reconnection logic (#​38290), which was fixed in v1.71.2, v1.72.2, v1.73.1, and all subsequent releases. We recommend upgrading.

• Add templating and support for Python 3.13. (#​37643)

v1.67.1

Compare Source

This is release gRPC Core 1.67.1 (gesundheit). This is a Python-only patch release.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

v1.67.0

Compare Source

This is release 1.67.0 (gesundheit) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [ruby] reduce an INFO log to DEBUG (backport #​37633). (#​37686)
• [release] Bump core version to 44.0.0. (#​37661)
• [RlsLB] Fix Deadlock. (#​37459)
• [Python Otel] Manage call tracer life cycle use call arena. (#​37460)

C++

• [OTel C++] Fix race when adding and removing callbacks. (#​37485)

Python

• [Backport to 1.67.x] Add templating and support for Python 3.13 (#​37643). (#​37803)
• Add templating and support for Python 3.13. (#​37643)
• [Python Distrib] Change warning to RuntimeError for version incompatibility. (#​37466)
• [reflection]: python: reflection returns original_request. (#​36944)

Ruby

• [ruby] drop ruby 2.7 support. (#​37430)
• [ruby] reduce ruby gpr_log invocations from INFO to DEBUG. (#​37426)
• [ruby] refactor flaky test and expose cancel_with_status. (#​37410)

v1.66.2

Compare Source

This is release gRPC Core 1.66.2 (gladiator).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

What's Changed

Python

• Added support for Python 3.13 and templating system for supported Python versions (#​37643)

Full Changelog: grpc/grpc@v1.66.1...v1.66.2

v1.66.1

Compare Source

This is release gRPC Core 1.66.1 (gladiator).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

Core

• Enable EDS dualstack support by default (#​37545)

v1.66.0

Compare Source

This is release 1.66.0 (gladiator) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [Python Otel] Manage call tracer life cycle use call arena. (v1.66.x backport). (#​37479)
• [BoringSSL] Update third_party/boringssl-with-bazel. (#​37223)
• [Dep] Upgrading Protobuf to v27.2. (#​36753)
• [Gpr_To_Absl_Logging] Fixing bugs . (#​36961)
• [chttp2] don't access endpoint in transport ops if it's already been destroyed. (#​36921)

C++

• [OTel C++] Fix race when adding and removing callbacks (#​37485). (#​37508)
• [RlsLB] Fix Deadlock (#​37459). (#​37502)

Python

• [Python Distrib] Change warning to RuntimeError for version incompatibility (v1.66.x backport). (#​37477)
• Fix issues/36613. (#​37022)
• [fix] updated invocation_metadata return type hint. (#​36894)
• [Release] Add warning about PyPi latest version not necessarily matching Github latest version. (#​36965)

Ruby

• [ruby] Update google-protobuf dep to allow 3.x and 4.x versions. (#​36982)
• [ruby] improve the way completion queue pluck operations handle signals and process shutdown. (#​36903)

v1.65.5

Compare Source

This is release gRPC Core 1.65.5 (gnarly).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

• [OTel C++] Fix race when adding and removing callbacks (#​37509)
• [RlsLB] Fix Deadlock (#​37503)
• [Python Otel] Manage call tracer life cycle use call arena. (v1.65.x backport) (#​37478)

v1.65.4

Compare Source

This is release gRPC Core 1.65.4 (gnarly).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

• #​37359 Fix a bug in hpack error handling

v1.65.2

Compare Source

This is release gRPC Core 1.65.2 (gnarly).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

v1.65.1

Compare Source

This is release gRPC Core 1.65.1 (gnarly).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

v1.65.0

Compare Source

This is release gRPC Core 1.65.0 (gnarly).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

This is release 1.65.0 (gnarly) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [OTPlugin] Per-channel OpenTelemetry plugin. (#​36729)
• [Gpr_To_Absl_Logging] Migrating from gpr to absl logging - gpr_set_log_function. (#​36844)
• [grpc][Gpr_To_Absl_Logging] Supporting verbosity flag. (#​36798)
• [build] Support clang-cl for Windows builds (best effort). (#​36831)
• [grpc][Gpr_To_Absl_Logging] Disable the ConfigVar because it wont work anymore. (#​36761)
• [BoringSSL] Update third_party/boringssl-with-bazel. (#​36716)
• [http2] Add experiment to modify behavior of GRPC_ARG_HTTP2_MAX_PINGS_WITHOUT_DATA to throttle pings instead of blocking. (#​36374)
• [xDS] fix "tls" channel cred in bootstrap to actually work. (#​36726)
• [StatsPlugin] Fix use-after-free issue. (#​36664)
• [EventEngine] Enable the EventEngine DNS Resolver on Windows. (#​36286)

C++

• [OTel] Generate pkg-config file for grpcpp_otel_plugin. (#​36686)
• [OTel] Add find_package call for OTel dependency in installed gRPC configuration. (#​36674)
• [OTel C++] Deprecate SetTargetAttributeFilter method on OpenTelemetryPluginBuilder. (#​36567)
• [security] Add notices for functions we will be removing. (#​36488)

Objective-C

• Replace bind() targets with alias() ones. (#​35272)

Python

• [Python O11y] Implement CSM observability for Python. (#​36557)
• [Python AIO] Return EOF from UnaryStreamCall.read() as documented. (#​36660)
• [Python Otel] Deprecate target_attribute_filter. (#​36697)
• [Python Server] Remove abstractmethod notation for add_registered_method_handlers. (#​36684)

Ruby

• [ruby] backport "Update google-protobuf dep to allow 3.x and 4.x versions (#​36982)" to 1.65.x. (#​37001)
• [ruby] backport "[ruby] improve the way completion queue pluck operations handle signals and process shutdown #​36903". (#​36916)

v1.64.3

Compare Source

This is release gRPC Core 1.64.3 (grateful).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

• #​37359 Fix a bug in hpack error handling

v1.64.1

Compare Source

This is release 1.64.1 (grateful) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [StatsPlugin] Fix use-after-free issue (#​36664). (#​36670)

C++

• [OTel] Generate pkg-config file for grpcpp_otel_plugin (#​36686). (#​36722)
• [OTel] Add find_package call for OTel dependency in installed gRPC configuration (#​36674). (#​36688)

Python

• [Python Server] Remove abstractmethod notation for add_registered_method_handlers (v1.64.x backport). (#​36696)

v1.64.0

Compare Source

This is release 1.64.0 (grateful) of gRPC Core.

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes, with highlights listed below.

Core

• [BoringSSL] Update third_party/boringssl-with-bazel. (#​36435)
• [build] Restrict visibility of grpc_public_hdrs and grpc++_public_hdrs. (#​36289)
• [Deps] Rollfoward Protobuf upgrade to v26.1. (#​36323)

C++

• [CSM] Fix CSM Observability for trailers-only response. (#​36413)
• [CSM] Remove requirement that servers have to be xDS enabled. (#​36410)

Python

• [Asyncio] Semantic task names for RPC tasks. (#​36422)
• [python/systemd] allow compiling systemd support into python builds. (#​36037)
• [Python Otel] Remove opentelemetry version pin. (#​36448)
• [Python Otel] Use registered method at server side. (#​36371)
• [Python grpcio_tools] Update version requirement of protobuf in grpcio_tools. (#​36230)

v1.63.2

Compare Source

This is release gRPC Core 1.63.2 (giggle).

For gRPC documentation, see grpc.io. For previous releases, see Releases.

This release contains refinements, improvements, and bug fixes.

• #​37359 Fix a bug in hpack error handling