---
id: fake-useragent
version: "2.2.0"
license: Apache-2.0
license_treatment: permissive
maintenance: abandoned
---

# fake-useragent — Up-to-date simple useragent faker with real world database

License: permissive · Maintenance: abandoned · Downloads: 10.9M/mo

## What it is and what it does

fake-useragent provides a simple interface to retrieve realistic user-agent strings without making external HTTP requests. The package ships with a pre-downloaded and post-processed database of real-world browser agents sourced from Intoli LLC, covering desktop, tablet, and mobile platforms across browsers like Chrome, Firefox, Safari, Edge, Opera, and others. You instantiate a UserAgent object and call properties like `.random`, `.chrome`, or `.firefox` to get strings, or use `.getRandom` and similar methods to retrieve full dictionaries with metadata like browser version, OS, and device brand.

The package is designed for web scraping, testing, and scenarios where you need to rotate or spoof browser identification. It supports filtering by specific browsers, operating systems, platform types (desktop/mobile/tablet), and minimum browser version. Since data is bundled with the package rather than fetched at runtime, there are no external dependencies or network calls, making it lightweight and reliable for offline use.

Use it for:

- Web scraping: rotate user-agent strings to avoid detection or blocking by servers.
- Automated testing: simulate requests from different browsers and devices in test suites.
- API client libraries: add realistic user-agent headers to HTTP requests without hardcoding.
- Bot development: generate varied user-agent strings for bots that need to appear as different browsers.
- Security testing: test how applications handle requests from diverse browser and OS combinations.

## Worth the install?

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

Generates random or browser-specific user-agent strings from a pre-packaged database of real-world agents, with filtering by browser, OS, platform type, and minimum version.

Yes, with caution about maintenance. The package is stable, has low install friction, and solves a real problem for web scraping and testing. However, the repository is now archived and abandoned, so the bundled user-agent database will not receive updates for new browser versions. Install it if your use case tolerates a static database; avoid it if you need current data for the latest browser releases or if you require ongoing bug fixes.

## Install

pip install fake-useragent
uv add fake-useragent
poetry add fake-useragent

## Installing fake-useragent

Before you install: Low install friction; single runtime dependency (importlib-resources). Repository is archived and marked abandoned as of the fact sheet date, with last commit on 2026-03-29, so maintenance has ceased.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with attribution and liability disclaimers.

Quickstart:

from fake_useragent import UserAgent
ua = UserAgent()
print(ua.random)  # Returns a random user-agent string
print(ua.chrome)  # Returns a Chrome user-agent
print(ua.getRandom)  # Returns full user-agent dictionary

Requires Python 3.9 or later.

Verify before relying:

- Whether the pre-packaged user-agent data is current enough for modern browser versions after the repository's abandonment.
- Whether the data source (Intoli LLC) continues to be updated or if the package's database is now static.
- Performance characteristics when filtering across large browser/OS/platform combinations.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 10.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

random user agent generator, fake useragent strings, browser user agent faker, user agent spoofing, mock browser identification, useragent database, user agent rotation, web-scraping, testing, user-agent

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