holidays
Generate and work with holidays and observances for countries worldwide.
Utilities PyPI MIT
How holidays is used
holidays is a dependency in 2 of the 6,208 public GitHub projects set up for AI coding agents that we scanned, too few to describe it from them alone. Our scan also samples projects by dependency (Solana 2,661, Ethereum and EVM 1,496, 3D and games 2,818, agent frameworks and SDKs 10,983); counting those, it appears in 56 projects, and what it is used with below comes from all of them. Projects that use it most often also use NumPy (94.6%), Matplotlib (92.9%), pandas (92.9%).
holidays popularity over time
Gid Score 53: downloads 82, use in agent projects 42, GitHub stars 23, downloads trend 55 (each 0-100). How it is calculated.
Often used with holidays
| NumPy | 94.6% of holidays projects · 16.2× more than average |
|---|---|
| Matplotlib | 92.9% of holidays projects · 34.5× more than average |
| pandas | 92.9% of holidays projects · 21.6× more than average |
| attrs | 91.1% of holidays projects · 131.5× more than average |
| Jinja2 | 91.1% of holidays projects · 41.9× more than average |
| MarkupSafe | 91.1% of holidays projects · 122.9× more than average |
From all 56 projects in our scan that use holidays, including the dependency samples.
How holidays is funded
Open Collective: Open World Holidays Framework
| Received, last 12 months | $0 Oct 2025 – Sep 2026 |
|---|---|
| Estimated annual budget | $0 Open Collective's estimate |
| Balance | $0 |
| Raised since the start | $0 |
| Contributors, last 12 months | 0 |
Oct 2025Sep 2026
USD after payment processor fees, as Open Collective reports it; fiscal host Open Source Collective. Source
Ways to fund holidays
Open Collective thanks.dev Tidelift
As the maintainers list them in FUNDING.yml on GitHub. Checked Oct 20, 2026.
Install
| Package | pip install holidays |
|---|---|
| Main stacks | Python (56) |
| Example projects | BlackArbsCEO/Adv_Fin_ML_Exercises, NNNightglow/replay, moizsaifee/kaggle-jigsaw-multilingual-toxic-comment-classification-3rd-place-solution, RoboFinSystems/robosystems, tomerwolgithub/question-decomposition-to-sql |
Alternatives to holidays
In our scan, none of the most used tools in Utilities does the same job as holidays: they are add-ons, companions or tools for a different task.
More in Utilities: clsx date-fns PyYAML uuid yaml js-yaml glob Lodash