random-user-agent

What it is and what it does

Random User Agent is a Python library that returns random user agent strings selected from a collection of over 326,000 agents. It lets you filter by operating system (Windows, Linux, Mac, Unix), hardware type (mobile, computer, server), software (browser, crawler, analyzer), specific browsers (Chrome, Firefox, Edge, Opera), rendering engine (Blink, Gecko, WebKit), and popularity tier (popular, common, average). You call UserAgent with your filter criteria and either retrieve a full list or a single random agent.

The package has no runtime dependencies and installs cleanly. However, it has been dormant since late 2018—the latest release is from December 2018 and the repository shows minimal recent activity. The user agent collection is unlikely to reflect current browser versions or modern user agent patterns, making it most useful for legacy systems or scenarios where exact currency is not critical.

Use it for:

• Rotate user agents in web scrapers to avoid detection by rotating through realistic browser identifiers
• Test web applications with a variety of user agent strings to verify browser compatibility and responsive behavior
• Generate realistic user agents for API clients or bots that need to mimic legitimate browser traffic
• Simulate requests from specific operating systems or browsers during load testing or quality assurance
• Populate user agent headers in HTTP clients when building tools that need to appear as real browsers

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides random user agent strings filtered by operating system, browser, hardware type, software engine, and popularity from a collection of over 326,000 user agents.

Yes, if you need a simple, dependency-free way to rotate user agents and can tolerate a static collection from 2018. The library is stable and permissive, but unsuitable if you need current user agent data or active maintenance. For projects requiring up-to-date agent strings, consider alternatives that maintain fresher datasets.

Install

random-user-agent on PyPI

pip install random-user-agent

uv add random-user-agent

poetry add random-user-agent

Installing random-user-agent

Before you install

Installation is straightforward with no runtime dependencies. However, the package is dormant—last release was 2018-12-26 and last commit 2024-07-07—so expect no active maintenance or updates to the underlying user agent collection.

License in practice

MIT license is permissive, allowing commercial and private use with minimal restrictions, making it safe to adopt in most projects.

Quickstart

from random_user_agent.user_agent import UserAgent
from random_user_agent.params import SoftwareName, OperatingSystem

user_agent_rotator = UserAgent(
    software_names=[SoftwareName.CHROME.value],
    operating_systems=[OperatingSystem.WINDOWS.value],
    limit=10
)
user_agents = user_agent_rotator.get_user_agents()
random_agent = user_agent_rotator.get_random_user_agent()

Verify before relying

• Whether the 326,000+ user agent collection is current or reflects agents from 2018 onward only
• How often the underlying user agent dataset is refreshed, if at all
• Compatibility with modern Python versions beyond 3.x declaration

Package facts

Evidence: random_user_agent-1.0.1-py3-none-any.whl

Tags

More WWW/HTTP packages

Further reading