NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1657 most downloaded on PyPI
Python library for easily interacting with trained machine learning models
Last release 2 days ago
02 Oct 2026
Release timing varies
gaps range from 8 days to 3 months
Nearly every release is documented
notes for 57 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
4 years old
122 releases · first in 2023
One column per quarter.
### Fixes - #13928 `131b5b7` - Stop the heartbeat of a Client garbage collected without close(), and on an error response instead of retrying in a loo
### Fixes - #13816 `ca09427` - Fix private Space file URLs in gr.load() and the JS client. Thanks @abidlabs!
### Features - #13779 `4eafc18` - Fix file URLs and sanitize invalid uploaded filenames. Thanks @abidlabs!
### Fixes - #13760 `7831e62` - Give the client's internal helper tasks their own thread pool. Thanks @hysts!
### Features - #13667 `2d753d0` - oauth: let API callers supply a token for endpoints that take a gr.OAuthToken, via oauth_token on the Python and JS
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!
Nothing published for this version
Nothing published for this version
### 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 - #11814 `013784a` - add validation support. Thanks @pngwn!
### Features - #11744 `f54e454` - fix client. Thanks @abidlabs!
Features #13851 afffecc - Add configurable tab overflow and alignment. Thanks @abidlabs ! Fixes #13817 81b7b77 - Several fixes related to rendering of
### Features - #11700 `37d4c48` - Have Client send authorization token with the X-HF-Authorization token. 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!
### Features - #8481 `41a4493` - fix client flaky tests. Thanks @abidlabs!
Your coding agent can read these notes before it upgrades. Set up the MCP server →