# kennethreitz/maya

Datetimes for Humans™

Repository: https://github.com/kennethreitz/maya
Canonical: https://ross.abutalabs.com/products/maya
Language: Python
License: MIT
License Family: permissive
Topics: datetimes, dates, times, date, time, python, forhumans, kennethreitz, parsing
Last push: 2024-07-19T13:04:30+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3548, "days_push": 775, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3411, forks 198 (observed 2026-08-28T04:08:03.403990+00:00)

## What it is
Maya is a Python library that provides a human-friendly API for working with datetimes, wrapping Python's datetime with simpler parsing, formatting, and timezone handling. It is especially designed for parsing datetime strings scraped from websites and converting between common formats like ISO 8601, RFC 2822, and RFC 3339.

## Use cases
- parse datetime strings from scraped web pages
- convert timestamps between iso8601, rfc2822, and rfc3339 formats
- get 'tomorrow' or other human-readable dates in python
- convert datetimes between timezones easily
- generate intervals of time between a start and end
- normalize naive and timezone-aware datetimes

## When to choose
- you want a simpler, human-friendly API over Python's datetime
- you need to parse messy datetime strings from websites
- you frequently convert between datetime string formats and timezones

## When to avoid
- you only need standard library datetime and want zero dependencies
- you need high-performance bulk datetime parsing
- the project appears to be in maintenance mode with limited new development

## Facets
- artifact type: library
- maturity: maintenance
- function: date-time, parser, serialization
- domain: developer-tools, web-development
- platform: python, cross-platform
- tags: datetimes, human-friendly-api, timezone-handling, iso8601, rfc2822, rfc3339, web-scraping-dates, automation

## Member repositories
- kennethreitz/maya (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:03.403990+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:38:31.159466+00:00, confidence not recorded.
  - readme: https://github.com/kennethreitz/maya (fetched 2026-08-28T04:08:03.403990+00:00, sha ee791ee23f57)
  - registry_pypi: https://pypi.org/pypi/maya/json (fetched 2026-08-29T09:32:37.829480+00:00, sha 35e0b519c5a6)
- Data as of 2026-08-30T08:39:29.467469+00:00.