ua-generator

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 on this page — 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

ua-generator on PyPI

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

Evidence: ua_generator-2.1.3-py3-none-any.whl

Tags

More WWW/HTTP packages

Further reading