---
id: random-user-agent
version: "1.0.1"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# random-user-agent — A package to get random user agents based filters provided by user

License: permissive · Maintenance: dormant · Downloads: 526.8K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 526.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

random user agent generator, user agent rotation, browser user agent strings, user agent filtering, web scraping user agents, rotate user agents, user agent library, user-agent-rotation, web-scraping, dormant

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