# faisalman/ua-parser-js

UAParser.js - The Essential Web Development Tool for User-Agent Detection. Detect Browsers, OS, Devices, Bots, Apps, AI Crawlers, and more. Run in Browser (client-side) or Node.js (server-side).

Repository: https://github.com/faisalman/ua-parser-js
Canonical: https://ross.abutalabs.com/products/ua-parser-js
Homepage: https://uaparser.dev/
Language: JavaScript
License: AGPL-3.0
License Family: copyleft
Topics: user-agent-parser, browser-detection, user-agent, client-hints, mobile-detection, analytics, bot-detection, device-detection
Last push: 2026-08-24T15:56:44+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 72, longevity 100
- inputs: {"age_days": 5328, "days_push": 9, "days_rel": 104, "gap_med": 34.0, "n_releases_24m": 13}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 10181, forks 1215 (observed 2026-08-28T04:10:39.794464+00:00)

## What it is
UAParser.js is a lightweight, dependency-free JavaScript library that parses User-Agent strings into structured data about browsers, OS, devices, CPUs, engines, bots, and AI crawlers. It runs isomorphically in browsers and Node.js and is actively maintained with an extensive detection database.

## Use cases
- parse user-agent strings in javascript
- detect browser and os from user agent
- identify mobile devices from user agent
- detect bots and ai crawlers in web traffic
- get device type and vendor from client signals
- server-side user agent detection in node.js
- analytics on what browsers visitors use

## When to choose
- you need fast, dependency-free user-agent parsing in browser or Node.js
- you want broad, actively maintained detection of browsers, devices, bots, and AI crawlers
- you need a tiny bundle (~12 kB) for client-side device detection

## When to avoid
- your project is not AGPL-compatible and you need the full v2 detection features without a commercial license
- you need high-accuracy device detection from client hints alone rather than user-agent strings
- you want a hosted device-detection API with continuous cloud-updated signatures

## Facets
- artifact type: library
- maturity: stable
- function: parser, analytics, developer-tools
- domain: web-development, analytics, developer-tools
- platform: browser, cross-platform
- tags: user-agent-parser, browser-detection, device-detection, bot-detection, client-hints, javascript, nodejs

## Member repositories
- faisalman/ua-parser-js (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:39.794464+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-29T17:19:39.103729+00:00, confidence not recorded.
  - readme: https://github.com/faisalman/ua-parser-js (fetched 2026-08-28T04:10:39.794464+00:00, sha 32d4799efe82)
  - homepage: https://uaparser.dev/ (fetched 2026-08-29T08:19:33.160607+00:00, sha f45c8b4cf98d)
  - site_page: https://docs.uaparser.dev (fetched 2026-08-29T08:19:33.169980+00:00, sha 4b70885a4cec)
- Data as of 2026-08-30T08:39:29.467469+00:00.
