NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1643 most downloaded on PyPI
Python library for easily interacting with trained machine learning models
Latest stable
2.7.2
Last release 12 days ago
09 Nov 2026
Release timing varies
gaps range from 8 days to 3 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
4 years old
123 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
### Features - #13585 `8888208` - Keep sessions (outputs, gr.State, running jobs) across refreshes, restarts and replicas. Thanks @dawoodkhan82! - #14
8888208 - Keep sessions (outputs, gr.State, running jobs) across refreshes, restarts and replicas. Thanks @dawoodkhan82!85357b1 - Wait until a prerendered page is shown before resuming its session. Thanks @hysts!dd82f43 - Remove gradio sketch and the vibe editor. Thanks @dawoodkhan82!466b764 - Stream each queued event on its own request (sse_v4). Thanks @abidlabs!db0658d - Mirror the webcam only for front-facing cameras by default. Thanks @hysts!Your coding agent can read these notes before it upgrades. Set up the MCP server →
### Fixes - #13981 `68a1122` - Don't save runs started by a Timer tick or a page load to run history. Thanks @hysts! - #13979 `1d6b6cb` - Save a .stre
### Fixes - #13903 `7ba5437` - Fix streaming gr.Audio getting stuck at "queue: 1/1" when stopped while waiting. Thanks @hysts!
### Features - #13843 `8193f16` - Speed up multipage app navigation. Thanks @abidlabs! ### Fixes - #13816 `ca09427` - Fix private Space file URLs in g
### Fixes - #13760 `7831e62` - Give the client's internal helper tasks their own thread pool. Thanks @hysts!
### Features - #13763 `7e83999` - add server-side run history in HF Hub buckets. Thanks @hannahblair! - #13779 `4eafc18` - Fix file URLs and sanitize
2d753d0 - oauth: let API callers supply a token for endpoints that take a gr.OAuthToken, via oauth_token on the Python and JS clients — sent only to endpoints that declare they need one. Thanks @abidlabs!7205856 - Preserve original filenames and MIME types when uploading File/Blob objects via the JS client, and use handle_file in the auto-generated JavaScript API snippets. Thanks @abidlabs!3b12faa - Keep in-flight events and generators working when an app is hot-reloaded (gradio app.py). Thanks @abidlabs!643fb05 - Restore Git tags for Python gradio_client releases. Thanks @abidlabs!95369a3 - Fix Windows filename/path handling (reserved names, node probe, file URLs). Thanks @abidlabs!### Features - #13718 `a9e8382` - Add browser-local run history and loading. Thanks @abidlabs!
### Features - #13246 `ff90963` - Add Documentation Group for gr.Cache. Thanks @freddyaboulton! ### Fixes - #13204 `9953db9` - fix: preserve special c
### Features - #13601 `0ee5cc8` - Preserve browser-visible proxy origins for frontend assets and API requests, and retain app-level FastAPI root paths
0ee5cc8 - Preserve browser-visible proxy origins for frontend assets and API requests, and retain app-level FastAPI root paths. Thanks @abidlabs!a10b1d7 - Fix private Space connections and error handling in the JS client: accept the deprecated hf_token option as an alias for token, raise clear errors when a Space is private or missing, tolerate malformed /info payloads instead of crashing with "Cannot read properties of undefined (reading 'map')", and make predict() reject with real Error objects instead of plain status objects that surface as unhandled promise rejections. Thanks @abidlabs!5200235 - Fix chained events after cancellation and while the browser tab is hidden. Thanks @abidlabs!2d753d0 - oauth: let API callers supply a token for endpoints that take a gr.OAuthToken, via oauth_token on the Python and JS clients — sent only to endpoints that declare they need one. Thanks @abidlabs!7205856 - Preserve original filenames and MIME types when uploading File/Blob objects via the JS client, and use handle_file in the auto-generated JavaScript API snippets. Thanks @abidlabs!e29c824 - Ship a real browser bundle for the documented CDN path (dist/index.min.js) and a CommonJS entry (dist/index.cjs via the require exports condition) for @gradio/client. Thanks @abidlabs!3b12faa - Keep in-flight events and generators working when an app is hot-reloaded (gradio app.py). Thanks @abidlabs!### Features - #13526 `53cb4ca` - Run pnpm lint and pnpm ts:check on CI. Thanks @abidlabs!
### Features - #12918 `e29e1cc` - Add Space-specific skill generation to gradio skills add. Thanks @abidlabs!
### Features - #12700 `b01c95a` - Rewrite behavior section of docs. Thanks @aliabd! ### Fixes - #12882 `fc7c01e` - Validate proxy url host. Thanks @fr
### Fixes - #12614 `6222192` - fix(client): make WebP and VTT MIME type detection case-insensitive. Thanks @majiayu000!
### Fixes - #12585 `1724a02` - Remove checkmark from windows. Thanks @freddyaboulton! - #12600 `1fafaba` - Add x-gradio-user-header. Thanks @freddyabo
### Fixes - #12480 `b9732d1` - [BUGFIX] Fix stream file download in gradio client. Thanks @frascuchon! - #12490 `472e164` - Make client backwards comp
Nothing published for this version
### Features - #12377 `568644a` - Add a 6.0 migration guide and add deprecation warnings. Thanks @abidlabs!
### Features - #12243 `cb49168` - [Client] Fix ZeroGPU headers forwarding. Thanks @cbensimon! - #12217 `681fa11` - Update ZeroGPU guide to reflect bes
### Features - #12069 `9de88ca` - Rename show_api. Thanks @freddyaboulton!
### Features - #11908 `53d9098` - [No Merge] Gradio 6.0. Thanks @freddyaboulton!
### Features - #14050 `fda8037` - Use the visitor's own HF token for run history buckets. Thanks @dawoodkhan82! ### Fixes - #13991 `fa3f296` - Run a d
### Features - #13585 `8888208` - Keep sessions (outputs, gr.State, running jobs) across refreshes, restarts and replicas. Thanks @dawoodkhan82! - #14
8888208 - Keep sessions (outputs, gr.State, running jobs) across refreshes, restarts and replicas. Thanks @dawoodkhan82!dd82f43 - Remove gradio sketch and the vibe editor. Thanks @dawoodkhan82!466b764 - Stream each queued event on its own request (sse_v4). Thanks @abidlabs!7907372 - Fix MCP prompts/get running the wrong endpoint and ignoring listed prompt names. Thanks @abidlabs!1cb9ae3 - Remove gr.Column and gr.Row variants. Thanks @dawoodkhan82!### Fixes - #11979 `50a89f0` - Allow gradio to run with huggingface_hub 1.x. Thanks @Wauplin!
### Features - #11962 `fdfe4fe` - fix(client): websockets minimum version for asyncio. Thanks @cbensimon!
### Fixes - #11896 `915f3a2` - Send EventData when app is loaded via gr.load. Thanks @freddyaboulton! - #11924 `a9167fb` - Update websocket import and
### Features - #13971 `b3c050c` - fit gr.workflow in full screen layouts. Thanks @hannahblair! ### Fixes - #13981 `68a1122` - Don't save runs started
68a1122 - Don't save runs started by a Timer tick or a page load to run history. Thanks @hysts!`70db61b` - Import CSV and TSV files dropped on gr.Dataframe. Thanks @hysts!
70db61b - Import CSV and TSV files dropped on gr.Dataframe. Thanks @hysts!0f889f0 - Clear the loading status when a validator rejects an event. Thanks @hysts!e918914 - Release the microphone when a streaming gr.Audio recording is stopped. Thanks @hysts!### Features - #13851 `afffecc` - Add configurable tab overflow and alignment. Thanks @abidlabs! ### Fixes - #13817 `81b7b77` - Several fixes related
### Fixes - #13765 `c6b9cc3` - Fix nested reactive render contexts. Thanks @abidlabs!
### Features - #13718 `a9e8382` - Add browser-local run history and loading. Thanks @abidlabs! - #13751 `1c8aa23` - Fix initial Spaces iframe resize a
### Fixes - #11041 `474aa30` - Attach cookies to client after first request (to support multiple-replica setups with cookie-based affinity). Thanks @a
### Fixes - #13708 `3458ea4` - Fix processing timer and other inherited text unreadable in dark mode. Thanks @hysts!
### Fixes - #11215 `2186ae3` - Allow httpx_kwargs to contain cookies. Thanks @santibreo!
### Fixes - #13687 `fd79d09` - Harden authentication and file redirect boundaries. Thanks @abidlabs! ### Dependency updates - @gradio/paramviewer@0.12
### Features - #13601 `0ee5cc8` - Preserve browser-visible proxy origins for frontend assets and API requests, and retain app-level FastAPI root paths
0ee5cc8 - Preserve browser-visible proxy origins for frontend assets and API requests, and retain app-level FastAPI root paths. Thanks @abidlabs!5200235 - Fix chained events after cancellation and while the browser tab is hidden. Thanks @abidlabs!7ac583a - Make builds go zoom zoom. Thanks @pngwn!3b12faa - Keep in-flight events and generators working when an app is hot-reloaded (gradio app.py). Thanks @abidlabs!f0abb1e - restore shared props lost during frontend prop partitioning. Thanks @dawoodkhan82!### Fixes - #11093 `cb322df` - Update client.py to always send file data, even for files without extensions. Thanks @edmcman!
### Features - #13566 `79b9171` - Gallery Download All. Thanks @dawoodkhan82! ### Fixes - #13563 `46d391b` - Fix embedded Gradio apps growing infinite
46d391b - Fix embedded Gradio apps growing infinitely tall on HF Spaces when using vh/% heights or fill_height. Thanks @abidlabs!2e80558 - Fire state.change() for streaming (.stream()) events. Thanks @hysts!745f20c - Fix gr.Tabs.select() event not firing when switching tabs. Thanks @abidlabs!9a72d0c - Fix Column staying hidden after a multi-yield visibility update. Thanks @hysts!### Features - #13526 `53cb4ca` - Run pnpm lint and pnpm ts:check on CI. Thanks @abidlabs! ### Dependency updates - @gradio/atoms@0.25.0 - @gradio/sta
### Features - #10664 `0b1f729` - Allow websocket version 15. Thanks @freddyaboulton! - Test
### Fixes - #10580 `4e70d74` - Fix gr.load() for gr.ChatInterface(save_history=True) and any Gradio app where the upstream app includes a gr.State as
### Features - #13509 `dcd072c` - Migrate Chatbot, Tabs, TabItem to Svelte 5. Thanks @dawoodkhan82! ### Fixes - #13521 `be20ce8` - Fix UI freeze when
### Features - #10352 `6a7cfc4` - Compatibility between Client and ZeroGPU. Thanks @abidlabs!
### Fixes - #10332 `e742dcc` - Allow users to add a custom API route. Thanks @aliabid94!
### Features - #10221 `506bd28` - Update Guides related to deploying Gradio chatbots to Discord, Slack, and website widgets. Thanks @abidlabs! ### Fix
### Features - #10196 `c9ba9a4` - Use the modern lower-case Python types in the API typing information. Thanks @abidlabs! - #10193 `424365b` - JSON ty
### Fixes - #13390 `d86903e` - Add Estonian language support and translation. Thanks @paulpall! ### Dependency updates - @gradio/html@0.12.4 - @gradio
### Features - #13289 `d6f24df` - Improve curl info. Thanks @freddyaboulton! - #13277 `cab8be0` - CLI/Agent API Docs. Thanks @freddyaboulton! ### Depe
d6f24df - Improve curl info. Thanks @freddyaboulton!cab8be0 - CLI/Agent API Docs. Thanks @freddyaboulton!### Fixes - #9913 `d81f430` - fix: Fix filename stripping to preserve extensions. Thanks @TakaSoap!
### Fixes - #9754 `36a5076` - Update client.py: raise error on 429 get_config. Thanks @Pendrokar!
Nothing published for this version
### Features - #9589 `477f45c` - Only move files to the cache that have a meta key. Thanks @freddyaboulton!
### Features - #9550 `b0fedd7` - Fix most flaky Python tests in 5.0-dev branch. Thanks @abidlabs! - #9483 `8dc7c12` - Send Streaming data over Websock
### Fixes - #9431 `7065e11` - Check for file_types parameter in the backend. Thanks @dawoodkhan82!
### Features - #9339 `4c8c6f2` - Ssr part 2. Thanks @pngwn!
### Features - #9200 `2e179d3` - prefix api routes. Thanks @pngwn!
### Features - #8968 `38b3682` - Improvements to FRP client download and usage. Thanks @abidlabs! - #9059 `981731a` - Fix flaky tests and tests on Win
### Features - #8862 `ac132e3` - Support the use of custom authentication mechanism, timeouts, and other httpx parameters in Python Client. Thanks @va
### Features - #8757 `6073736` - Document FileData class in docs. Thanks @hannahblair!
### Fixes - #8505 `2943d6d` - Add Timer component. Thanks @aliabid94!
### Features - #8516 `de6aa2b` - Add helper classes to docs. Thanks @aliabd!
One column per quarter.