---
id: ua-generator
version: "2.1.3"
license: unclear
license_treatment: permissive
maintenance: active
---

# ua-generator — A random user-agent generator

License: permissive · Maintenance: active · Downloads: 952.7K/mo

## What it is and what it does

ua-generator creates randomized user-agent strings that mimic real browsers and devices without relying on external data sources or downloads. The package hardcodes browser and platform versions based on actual releases, allowing you to generate strings for specific combinations of device type (desktop/mobile), platform (Windows, macOS, iOS, Linux, Android), and browser (Chrome, Edge, Firefox, Safari). It also generates corresponding Client Hints headers (Sec-CH-UA fields) that match the user-agent, making it suitable for integration with HTTP libraries like requests, httpx, urllib, and Selenium.

The package has no runtime dependencies and requires only Python 3.9 or later. You can customize generation with options like weighted version selection (favoring newer versions), version ranges, and latest-version-only filtering. The generated output includes the user-agent string itself, parsed metadata (platform, browser), and a headers helper that constructs a complete dictionary of HTTP headers ready to pass to requests or other HTTP clients.

Use it for:

- Rotate realistic user-agents in web scrapers to avoid detection and blocking
- Test HTTP client libraries and servers with varied user-agent strings and Client Hints
- Integrate randomized user-agents into Selenium automation to mimic real browser behavior
- Generate matching user-agent and Sec-CH-UA headers for modern web requests
- Populate test fixtures with realistic browser/platform combinations

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Generates realistic, randomized user-agent strings for modern browsers and platforms without external dependencies or downloads.

Yes. The package is lightweight, dependency-free, actively maintained, and solves a common need in web automation and testing. It covers modern browsers and platforms with hardcoded versions and includes Client Hints support. The recent release cycle and zero vulnerabilities make it a low-risk choice.

## Install

pip install ua-generator
uv add ua-generator
poetry add ua-generator

## Installing ua-generator

Before you install: Installs cleanly with no runtime dependencies. Actively maintained with a recent release (12 days old) and steady repository activity.

License in practice: Licensed under Apache Software License (permissive), allowing use in commercial and private projects without significant restriction.

Quickstart:

pip install ua-generator

import ua_generator

ua = ua_generator.generate()
print(ua.text)  # Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_3) ...
print(ua.headers.get())  # Dict with user-agent and Sec-CH-UA headers

Requires Python >= 3.9

Verify before relying:

- Whether hardcoded user-agent versions remain current between releases without automatic updates
- Performance characteristics when generating large batches of user-agents

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 952.7K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

random user agent generator, user-agent string generation, browser user agent faker, http client hints generator, realistic user agent strings, web-scraping, http-headers, testing

[View on SkillFed](https://skillfed.io/packages/ua-generator) · [View on PyPI](https://pypi.org/project/ua-generator/)