PyPI
huggingface-hub
Client library to download and publish models, datasets and other repos on the huggingface.co hub
deep-learninghacktoberfestmachine-learningmodel-hubmodelsnatural-language-processingpretrained-modelspytorch
github.com/huggingface/huggingface_hubApache-2.0Hugging Face, Inc.67.5M / week4k · 1.3k forks · 398 contributors
Release cadenceEvery 7 days
Last releaseOct 29, 2026
Open advisories0
Changelog quality56% curated
GitHub Releases, gaps for some releases
Release history SecurityYou're on
82 older or filtered releases not shown.
Upgrade guides
Breaking changes and a migration checklist for each major versionhuggingface-hub 1 → 21.33.0 → 2.4.0Oct 29, 2026 BreakingBreaking20Security1Platform1New13Changed16Fixed38Other33huggingface-hub 0.36 → 10.36.2 → 1.33.0Sep 24, 2026 BreakingBreaking55Security11Platform3Deprecated15New219Changed168Fixed189Other269huggingface-hub 0.35 → 0.360.35.3 → 0.36.2Feb 6, 2026 UnknownSecurity1New3Changed5Fixed10Other8huggingface-hub 0.34 → 0.350.34.6 → 0.35.3Sep 29, 2025 UnknownDeprecated1New13Changed15Fixed17Other14huggingface-hub 0.33 → 0.340.33.5 → 0.34.6Sep 16, 2025 BreakingBreaking1Deprecated1New8Changed14Fixed19Other16huggingface-hub 0.32 → 0.330.32.6 → 0.33.5Jul 24, 2025 BreakingBreaking4New4Changed2Fixed12Other6huggingface-hub 0.31 → 0.320.31.4 → 0.32.6Jun 11, 2025 UnknownNew15Changed8Fixed16Other6huggingface-hub 0.30 → 0.310.30.2 → 0.31.4May 19, 2025 BreakingBreaking5New13Changed10Fixed14Other15huggingface-hub 0.29 → 0.300.29.3 → 0.30.2Apr 8, 2025 BreakingBreaking1New21Changed9Fixed15Other16huggingface-hub 0.28 → 0.290.28.1 → 0.29.3Mar 11, 2025 BreakingBreaking1Security1Deprecated1New14Changed5Fixed12Other11huggingface-hub 0.27 → 0.280.27.1 → 0.28.1Jan 30, 2025 BreakingBreaking1New6Changed4Fixed10Other9huggingface-hub 0.26 → 0.270.26.5 → 0.27.1Jan 6, 2025 BreakingBreaking5Platform1Deprecated2New5Changed4Fixed17Other12huggingface-hub 0.25 → 0.260.25.2 → 0.26.5Dec 6, 2024 BreakingBreaking3Platform1Deprecated1New7Changed3Fixed10Other10huggingface-hub 0.24 → 0.250.24.7 → 0.25.2Oct 9, 2024 BreakingBreaking3Deprecated1New20Changed20Fixed31Other18huggingface-hub 0.23 → 0.240.23.5 → 0.24.7Sep 12, 2024 BreakingBreaking3Deprecated2New25Changed7Fixed31Other32huggingface-hub 0.22 → 0.230.22.2 → 0.23.5Jul 16, 2024 BreakingBreaking5Deprecated1New13Changed13Fixed14Other48huggingface-hub 0.21 → 0.220.21.4 → 0.22.2Mar 29, 2024 BreakingBreaking3New6Changed5Fixed23Other13huggingface-hub 0.20 → 0.210.20.3 → 0.21.4Mar 6, 2024 BreakingBreaking1Deprecated4New7Changed12Fixed18Other29huggingface-hub 0.19 → 0.200.19.4 → 0.20.3Jan 22, 2024 BreakingBreaking4Deprecated3New16Changed12Fixed25Other23huggingface-hub 0.18 → 0.190.18.0 → 0.19.4Nov 16, 2023 BreakingBreaking2Security1Deprecated2New5Changed9Fixed17Other16huggingface-hub 0.17 → 0.180.17.3 → 0.18.0Oct 10, 2023 BreakingBreaking1New4Changed7Fixed14Other17huggingface-hub 0.16 → 0.170.16.4 → 0.17.3Sep 26, 2023 BreakingBreaking1New50Changed3Fixed8Other23huggingface-hub 0.15 → 0.160.15.1 → 0.16.4Jul 7, 2023 BreakingBreaking1New9Changed8Fixed4Other8huggingface-hub 0.14 → 0.150.14.1 → 0.15.1Jun 1, 2023 BreakingBreaking2New8Fixed6Other5huggingface-hub 0.13 → 0.140.13.4 → 0.14.1Apr 25, 2023 BreakingBreaking1Security1New12Changed5Fixed12Other12huggingface-hub 0.12 → 0.130.12.1 → 0.13.4Apr 6, 2023 BreakingBreaking1Security2New8Changed7Fixed10Other6huggingface-hub 0.11 → 0.120.11.1 → 0.12.1Feb 17, 2023 BreakingBreaking6Security2New9Changed7Fixed11Other31huggingface-hub 0.10 → 0.110.10.1 → 0.11.1Nov 28, 2022 BreakingBreaking4Deprecated3New13Changed8Fixed15Other19huggingface-hub 0.9 → 0.100.9.1 → 0.10.1Oct 11, 2022 BreakingBreaking3Deprecated3New12Changed14Fixed12Other3huggingface-hub 0.8 → 0.90.8.1 → 0.9.1Aug 25, 2022 UnknownNew7Changed10Fixed8Other12huggingface-hub 0.7 → 0.80.7.0 → 0.8.1Jun 21, 2022 BreakingBreaking1Deprecated1New4Changed9Fixed4Other4huggingface-hub 0.6 → 0.70.6.0 → 0.7.0May 24, 2022 UnknownNew2Changed1Fixed1huggingface-hub 0.5 → 0.60.5.1 → 0.6.0May 11, 2022 BreakingBreaking1New5Changed2Fixed2Other12huggingface-hub 0.4 → 0.50.4.0 → 0.5.1Apr 6, 2022 BreakingBreaking2Platform1Deprecated2New9Changed5Fixed6Other23huggingface-hub 0.2 → 0.40.2.1 → 0.4.0Jan 11, 2022 Review neededNew5Changed2Fixed4Other4huggingface-hub 0.1 → 0.20.1.2 → 0.2.1Dec 3, 2021 Review neededNew3Changed1Fixed1huggingface-hub 0.0 → 0.10.0.19 → 0.1.2Nov 8, 2021 Review neededNew5Changed3Fixed3
VersionChannelDateChangesSecurity
2.4.0 StableOct 29, 2026No changes listed2.4.0rc0 RCOct 29, 2026No changes listed2.3.0 youStableOct 23, 2026Platform1New6Changed2Fixed15Other132.3.0rc1 RCOct 22, 2026No notes published2.3.0rc0 RCOct 22, 2026No notes published2.2.0 StableOct 8, 2026Breaking2Changed5Fixed15Other92.2.0rc0 RCOct 8, 2026No notes published2.1.1 StableOct 1, 2026Breaking12.1.0 YankedOct 1, 2026Breaking1Security1New7Changed9Fixed8Other92.1.0rc0 RCOct 1, 2026No notes published2.0.0 StableSep 24, 2026Breaking16Changed1Other22.0.0rc0 RCSep 24, 2026No notes published1.33.0 StableSep 24, 2026Breaking1Deprecated2New1Changed5Fixed15Other41.33.0rc1 RCSep 24, 2026No notes published1.33.0rc0 RCSep 24, 2026No notes published1.32.0 StableSep 17, 2026Security4New7Changed6Fixed11Other51.32.0rc0 RCSep 17, 2026No notes published1.31.0 StableSep 10, 2026Security1New2Changed1Fixed11Other31.31.0rc1 RCSep 10, 2026No notes published1.31.0rc0 RCSep 10, 2026No notes published