{"id":13488585,"url":"https://github.com/fake-useragent/fake-useragent","last_synced_at":"2025-12-12T01:04:51.217Z","repository":{"id":41293785,"uuid":"8550252","full_name":"fake-useragent/fake-useragent","owner":"fake-useragent","description":"Up-to-date simple useragent faker with real world database","archived":false,"fork":false,"pushed_at":"2025-05-11T05:02:43.000Z","size":1429,"stargazers_count":3889,"open_issues_count":12,"forks_count":524,"subscribers_count":61,"default_branch":"main","last_synced_at":"2025-05-12T00:59:43.243Z","etag":null,"topics":["agent","fake","faker","python","python3","scraping","user","user-agent","user-agent-spoofer","useragent","useragent-scraper"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/fake-useragent","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fake-useragent.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-03-04T07:14:29.000Z","updated_at":"2025-05-11T04:55:56.000Z","dependencies_parsed_at":"2022-08-29T16:40:06.972Z","dependency_job_id":"aec520d2-1a99-42ca-999c-eba8ad2f1d90","html_url":"https://github.com/fake-useragent/fake-useragent","commit_stats":{"total_commits":286,"total_committers":14,"mean_commits":"20.428571428571427","dds":0.6503496503496504,"last_synced_commit":"f2053bf67e913a33226c3cac1ae287080f07ff9c"},"previous_names":["hellysmile/fake-useragent"],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fake-useragent%2Ffake-useragent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fake-useragent%2Ffake-useragent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fake-useragent%2Ffake-useragent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fake-useragent%2Ffake-useragent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fake-useragent","download_url":"https://codeload.github.com/fake-useragent/fake-useragent/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253655955,"owners_count":21943081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","fake","faker","python","python3","scraping","user","user-agent","user-agent-spoofer","useragent","useragent-scraper"],"created_at":"2024-07-31T18:01:18.440Z","updated_at":"2025-12-12T01:04:51.174Z","avatar_url":"https://github.com/fake-useragent.png","language":"Python","funding_links":[],"categories":["Python","Others","\u003ca name=\"utils--user-agents\"\u003e\u003c/a\u003e🧰 Utils \u0026 User Agents","Web Automation and UI Interaction"],"sub_categories":["Browser Automation"],"readme":"[![Test \u0026 Deploy fake-useragent](https://github.com/fake-useragent/fake-useragent/actions/workflows/action.yml/badge.svg?branch=main)](https://github.com/fake-useragent/fake-useragent/actions/workflows/action.yml?query=branch%3Amain)\n[![Ruff linter](https://github.com/fake-useragent/fake-useragent/actions/workflows/ruff.yml/badge.svg?branch=main)](https://github.com/fake-useragent/fake-useragent/actions/workflows/ruff.yml?query=branch%3Amain)\n[![CodeQL](https://github.com/fake-useragent/fake-useragent/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/fake-useragent/fake-useragent/actions/workflows/codeql.yml?query=branch%3Amain)\n\n# fake-useragent\n\nUp-to-date simple useragent faker with real world database.\n\n## Features\n\n- Data is pre-downloaded \u0026 post-processed from [Intoli LLC](https://github.com/intoli/user-agents/tree/main/src) and the data is part of the package itself\n- The data consists of a wide range of browser agents and various browsers\n- Retrieves user-agent strings (both of type: `desktop`, `tablet` and/or `mobile` UAs)\n- Retrieve user-agent Python dictionary (aka object), with fields like `useragent`, `percent`, `type`, `device_brand`, `browser`, `browser_version`, `os`, `os_version` and `platform`\n- Supports Python 3.9 or higher\n\n### Installation\n\n```sh\npip install fake-useragent\n```\n\nOr if you have multiple Python / pip versions installed, use `pip3`:\n\n```sh\npip3 install fake-useragent\n```\n\n### Usage\n\nSimple usage examples below, see also next chapters in this readme for more advanced usages:\n\n```py\nfrom fake_useragent import UserAgent\nua = UserAgent()\n\n# Get a random browser user-agent string\nprint(ua.random)\n# Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:132.0) Gecko/20100101 Firefox/132.0\n\n# Or get user-agent string from a specific browser\nprint(ua.chrome)\n# Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36\nprint(ua.google)\n# Mozilla/5.0 (iPhone; CPU iPhone OS 18_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) GSA/343.0.695551749 Mobile/15E148 Safari/604.1\nprint(ua['Chrome'])\n# Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36\nprint(ua.firefox)\n# Mozilla/5.0 (Android 14; Mobile; rv:133.0) Gecko/133.0 Firefox/133.0\nprint(ua.ff)\n# Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:132.0) Gecko/20100101 Firefox/132.0\nprint(ua.safari)\n# Mozilla/5.0 (iPhone; CPU iPhone OS 17_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6 Mobile/15E148 Safari/604.1 Ddg/17.6\nprint(ua.opera)\n# Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36 OPR/114.0.0.0\nprint(ua.edge)\n# Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36 Edg/125.0.0.0\n```\n\n#### Additional usage\n\nAdditional features that fake-useragent now offers since v1.2.0.\n\nIf you want to specify your own browser list, you can do that via the `browsers` argument (default is: `[\"Google\", \"Chrome\", \"Firefox\", \"Edge\", \"Opera\", \"Safari\", \"Android\", \"Yandex Browser\", \"Samsung Internet\", \"Opera Mobile\", \"Mobile Safari\", \"Firefox Mobile\", \"Firefox iOS\", \"Chrome Mobile\", \"Chrome Mobile iOS\", \"Mobile Safari UI/WKWebView\", \"Edge Mobile\", \"DuckDuckGo Mobile\", \"MiuiBrowser\", \"Whale\", \"Twitter\", \"Facebook\", \"Amazon Silk\"]`).  \nThis example will only return random user-agents from Edge and Chrome:\n\n```py\nfrom fake_useragent import UserAgent\nua = UserAgent(browsers=['Edge', 'Chrome'])\nua.random\n```\n\n_Note:_ Fakeuser-agent knowns about browsers: Chrome, Edge, Firefox, Safari, Opera, Android, Opera Mobile, Mobile Safari, Firefox Mobile, Firefox iOS, Chrome Mobile, Chrome Mobile iOS and more (see again full list above).  \n_Note #2:_ Since fakeuser-agent v2.0.0 the browser names are case-sensitive!\n\n---\n\nIf you want to specify your own operating systems, you can do that via the `os` argument (default is: `[\"Windows\", \"Linux\", \"Ubuntu\", \"Chrome OS\", \"Mac OS X\", \"Android\", \"iOS\"]`).  \nIn this example you will only get Linux user-agents back:\n\n```py\nfrom fake_useragent import UserAgent\nua = UserAgent(os='Linux')\nua.random\n```\n\n_Note:_ Since fakeuser-agent v2.0.0 the OS names are case-sensitive!\n\n---\n\nYou can also specify the type of platforms you want to use, you can do that via the `platforms` argument (default is `[\"desktop\", \"mobile\", \"tablet\"]`).\nThis example will only return random user-agents from a mobile device:\n\n```py\nfrom fake_useragent import UserAgent\nua = UserAgent(platforms='mobile')\nua.random\n```\n\nAnd a random user-agent from a desktop device:\n\n```py\nfrom fake_useragent import UserAgent\nua = UserAgent(platforms='desktop')\nua.random\n```\n\n---\n\nIf you want to return more recent user-agent strings, you can play with the `min_version` argument (default is: `0.0`, meaning all user agents will match).  \nIn this example you get only user agents that have a minimum version of 120.0:\n\n```py\nfrom fake_useragent import UserAgent\nua = UserAgent(min_version=120.0)\nua.random\n```\n\n---\n\nFor backwards compatibility, a minimum usage percentage can still be specified with the `min_percentage` argument. However, the current list of user agents does\nnot contain this statistic. Therefore all of the user-agents will match.\n\n---\n\n_Hint:_ Of-course you can **combine all those arguments** to you liking!\n\n#### User-agent Python Dictionary\n\nSince version 1.3.0 we now also offer you the following \"get\" properties which return the whole Python dictionary of the UA, instead of only the user-agent string:\n\n\u003e **Warning**\n\u003e Raw JSON objects (in a Python dictionaries) are returned \"as is\".\n\u003e Meaning, this data structure could change in the future!\n\u003e\n\u003e Be aware that these \"get\" properties below might not return the same key/value pairs in the future.\n\u003e Use `ua.random` or alike as mentioned above, if you want to use a stable interface.\n\n```py\nfrom fake_useragent import UserAgent\nua = UserAgent()\n\n# Random user-agent dictionary (object)\nua.getRandom\n# {'percent': 0.8, 'useragent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36 Edg/116.0.1938.76', 'system': 'Edge 116.0 Win10', 'browser': 'edge', 'version': 116.0, 'os': 'win10'}\n\n# More get properties:\nua.getFirefox\n# {'percent': 0.3, 'useragent': 'Mozilla/5.0 (Windows NT 10.0; rv:109.0) Gecko/20100101 Firefox/118.0', 'system': 'Firefox 118.0 Win10', 'browser': 'firefox', 'version': 118.0, 'os': 'win10'}\nua.getChrome\nua.getSafari\nua.getEdge\n\n# And a method with an argument.\n# This is exactly the same as using: ua.getFirefox\nua.getBrowser('firefox')\n```\n\n### Notes\n\nYou can override the fallback string using the `fallback` parameter, in very rare cases something failed:\n\n```py\nfrom fake_useragent import UserAgent\n\nua = UserAgent(fallback='your favorite Browser')\n# in case if something went wrong, one more time it is REALLY!!! rare case\nua.random == 'your favorite Browser'\n```\n\nIf you will try to get unknown browser:\n\n```py\nfrom fake_useragent import UserAgent\nua = UserAgent()\nprint(ua.unknown)\n#Error occurred during getting browser: randm, but was suppressed with fallback.\n#Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 Edg/122.0.0.0\n```\n\nIf you need to safe some attributes from overriding them in UserAgent by `__getattr__` method\nuse `safe_attrs` you can pass there attributes names.\nAt least this will prevent you from raising FakeUserAgentError when attribute not found.\n\nFor example, when using fake*useragent with `injections \u003chttps://github.com/tailhook/injections\u003e`* you need to:\n\n```py\nfrom fake_useragent import UserAgent\n\nua = UserAgent(safe_attrs=('__injections__',))\n```\n\nPlease, do not use if you don't understand why you need this.\nThis is magic for rarely extreme case.\n\n### Experiencing issues?\n\nMake sure that you using latest version!\n\n```sh\npip install --upgrade fake-useragent\n```\n\nOr if that isn't working, try to install the latest package version like this (`2.0.3` is an example, check what the [latest version is on PyPi](https://pypi.org/project/fake-useragent/#history)):\n\n```sh\npip install fake-useragent==2.0.3\n```\n\nCheck version via the Python console:\n\n```py\nimport fake_useragent\n\nprint(fake_useragent.__version__)\n```\n\nAnd you are always welcome to post [issues](https://github.com/fake-useragent/fake-useragent/issues).\n\nPlease do not forget to mention the version that you are using.\n\n### For Developers\n\n#### User-agent Data\n\nThe user-agent data we retrieve from [user-agents.net](https://user-agents.net). Data is stored in [JSONlines](https://jsonlines.org/) format. File is located in the: `src/fake_useragent/data` directory.\n\nThe data JSON file is part of the Python package, see [pyproject.toml](pyproject.toml). Read more about [Data files support](https://setuptools.pypa.io/en/latest/userguide/datafiles.html).\n\n#### Python Virtual Environment\n\nWe encourage to use Python virtual environment before installing Pip packages, like so:\n\n```sh\npython -m virtualenv env\nsource env/bin/activate\n```\n\n#### Local Install\n\n```sh\npip install -e .\n```\n\n#### Tests\n\n```sh\npip install -r requirements.txt\ntox\n```\n\n#### Linting\n\nTo fix imports using ruff:\n\n```sh\npip install -r requirements.txt\nruff check --select=\"I\" --fix .\n```\n\nFix black code formatting errors:\n\n```sh\npip install -r requirements.txt\nblack .\n```\n\n_Note:_ When ruff v1.0 releases, we most likely move fully towards `ruff` instead of `black`.\n\n### Changelog\n\n- 2.2.0 April 14, 2025\n\n  - Updated user agents file (JSONL)\n  - Updated dependencies\n  - Python 3.8 support is officially dropped\n  - Python 3.13 support is added\n  - Improved `pyproject.toml` file\n\n- 2.1.0 March 12, 2025\n\n  - Speed up the UA converter script and add it to workflow via cronjob\n  - Dump up dependencies versions\n  - Updated user agents file (JSONB)\n  - Improved safe attrs checker and added `shape` as safe attr by default (for IDE).\n \n\n- 2.0.2 \u0026 2.0.3 December 10, 2024\n\n  -  Fix project dependencies toml file \u0026 sync docs\n\n- 2.0.1 December 7, 2024 (my birthday)\n\n  - Add requires-python to toml config\n\n- 2.0.0 December 4, 2024\n\n  - Switch to new data source (again again)\n  - Possible browser options: `\"Google\", \"Chrome\", \"Firefox\", \"Edge\", \"Opera\", \"Safari\", \"Android\", \"Yandex Browser\", \"Samsung Internet\", \"Opera Mobile\",\n\"Mobile Safari\", \"Firefox Mobile\", \"Firefox iOS\", \"Chrome Mobile\", \"Chrome Mobile iOS\", \"Mobile Safari UI/WKWebView\",\n\"Edge Mobile\", \"DuckDuckGo Mobile\", \"MiuiBrowser\", \"Whale\", \"Twitter\", \"Facebook\", \"Amazon Silk\"`\n  - Possible OS options: `\"Windows\", \"Linux\", \"Ubuntu\", \"Chrome OS\", \"Mac OS X\", \"Android\", \"iOS\"`\n  - Possible type options: `\"desktop\", \"mobile\", \"tablet\"`\n  - Update fake.py to handle the new data key/value objects\n  - Updated the README\n  - Renamed browsers.json to browsers.jsonl. And other refactors.\n\n- 1.5.1 March 16, 2024\n\n  - Remove trailing spaces in user agent strings\n\n- 1.5.0 March 8, 2024\n\n  - Migrated to new user-agent data source (thanks @BoudewijnZwart), backwards compatible API.\n  - Update all pip package dependencies to latest stable versions\n\n- 1.4.0 November 24, 2023\n\n  - Update all PIP packages\n  - Support Python 3.12 (thanks @vladkens)\n  - Fix package conflict in cache scraper\n  - Improve ruff CLI calls\n\n- 1.3.0 October 2, 2023\n\n  - Introducing new `ua.getRandom`, `ua.getFirefox`, `ua.getChrome`, `ua.getSafari`. And a generic method: `ua.getBrowser(..)` (eg. `getBrowser('firefox')`)\n    - These new properties above allows you to retrieve the whole raw Python dictionary, instead of only the UA string.\n    - These properties might return different key/values pairs in the future!\n  - Fix the `os` argument 'windows' to check for both `win10`and `win7` values (previously only checking on `win10`), thus returning more UAs\n  - Improved user-agent scraper (now also containing Safari browser again)\n  - Updated browsers.json data file\n\n- 1.2.1 August 2, 2023\n\n  - Small improvements in the `min_percentage` check\n  - Update all Pip package dependencies\n\n- 1.2.0 August 2, 2023\n\n  - Updated browser useragent data\n  - Allow filters on browser, OS and usage percentage\n  - Update the cache scraper to scape the new data source for user-agent strings\n  - Adapted the code to work with the new JSON data format\n  - Parameter `use_external_data=True` and `verify_ssl` are **removed**. If you use those parameters, just remove it in your code!\n\n- 1.1.3 March 20, 2023\n\n  - Update dependencies\n\n- 1.1.2 February 8, 2023\n\n  - Security fixes\n\n- 1.1.1 December 4, 2022\n\n  - Remove whitespaces from user agent strings, this is a patch release\n\n- 1.1.0 November 26, 2022\n\n  - Add `pkg_resource` as fallback mechanism in trying to retrieve the local JSON data file\n\n- 1.0.1 November 10, 2022\n\n  - Add `importlib-metadata` \u0026 `importlib-resources` as dependencies\n  - Check on specific Python version regarding the importlib resources (python v3.10 or higher) in order to have `files()` working\n  - `importlib_metadata` should now also work on Python version before 3.8\n  - Remove obsolete `MANIFEST.in` file\n\n- 1.0.0 November 17, 2022\n\n  - Make the JSON Lines data file part of the Python package, data is retrieved locally\n    - Extend the `myproject.toml` file with `package-data` support\n  - Remove centralized caching server implementation\n  - Make real unit-tests which should run reliable, fast, independent and without Internet connection\n\n- 0.1.14 November 5, 2022\n\n  - Improve code quality standards using modern Python \u003e=3.7 syntax\n  - Migrated to `pyproject.toml` build system format + syntax check\n  - Add additional classifiers to the toml file\n  - Improved `tox.ini` file\n  - Improved GitHub Actions job using pip cache\n  - And various small fixes\n\n- 0.1.13 October 21, 2022\n\n  - Implement `browsers` argument, allowing you to override the browser names you want to use\n  - Fix browser listing of Internet Explorer and Edge\n  - Don't depend on w3schools.com anymore\n  - Clean-up data (temp) file format\n  - Update fallback cache server URL / use JSON Lines as file format\n  - Move to GitHub Actions instead of Travis\n  - Using [`black`](https://pypi.org/project/black/) Python formatter in favour of Flake\n\n- 0.1.12 March 31, 2022\n\n  - forked\n\n- 0.1.11 October 4, 2018\n\n  - moved `s3 + cloudfront` fallback to `heroku.com`, cuz someone from Florida did ~25M requests last month\n\n- 0.1.10 February 11, 2018\n\n  - Minor fix docs `cloudfront` url\n\n- 0.1.9 February 11, 2018\n\n  - fix `w3schools.com` renamed `IE/Edge` to `Edge/IE`\n  - moved `heroku.com` fallback to `s3 + cloudfront`\n  - stop testing Python3.3 and pypy\n\n- 0.1.8 November 2, 2017\n\n  - fix `useragentstring.com` `Can't connect to local MySQL server through socket`\n\n- 0.1.7 April 2, 2017\n\n  - fix broken README.rst\n\n- 0.1.6 April 2, 2017\n\n  - fixes bug `use_cache_server` do not affected anything\n  - `w3schools.com \u003chttps://www.w3schools.com/browsers/browsers_stats.asp\u003e`\\_ moved to `https`\n  - `verify_ssl` options added, by default it is `True` (`urllib.urlopen` ssl context for Python 2.7.9- and 3.4.3- is not supported)\n\n- 0.1.5 February 28, 2017\n\n  - added `ua.edge` alias to Internet Explorer\n  - w3schools.com starts displaying `Edge` statistic\n  - Python 2.6 is not tested anymore\n  - `use_cache_server` option added\n  - Increased `fake_useragent.settings.HTTP_TIMEOUT` to 5 seconds\n\n- 0.1.4 December 14, 2016\n\n  - Added custom data file location support\n  - Added `fallback` browser support, in case of unavailable data sources\n  - Added alias `fake_useragent.FakeUserAgent` for `fake_useragent.UserAgent`\n  - Added alias `fake_useragent.UserAgentError` for `fake_useragent.FakeUserAgentError`\n  - Reduced `fake_useragent.settings.HTTP_TIMEOUT` to 3 seconds\n  - Started migration to new data file format\n  - Simplified a lot 4+ years out of date code\n  - Better thread/greenlet safety\n  - Added verbose logging\n  - Added `safe_attrs` for prevent overriding by `__getattr__`\n\n- 0.1.3 November 24, 2016\n\n  - Added hosted data file, when remote services is unavailable\n  - Raises `fake_useragent.errors.FakeUserAgentError` in case when there is not way to download data\n  - Raises `fake_useragent.errors.FakeUserAgentError` instead of `None` in case of unknown browser\n  - Added `gevent.sleep` support in `gevent` patched environment when trying to download data\n\n- X.X.X xxxxxxx xx, xxxx\n  - xxxxx ?????\n\n### Authors\n\nYou can visit [authors page](https://github.com/fake-useragent/fake-useragent/blob/main/AUTHORS).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffake-useragent%2Ffake-useragent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffake-useragent%2Ffake-useragent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffake-useragent%2Ffake-useragent/lists"}