Beautiful Soup Installation

Oct 6, 2023 ยท 2 min read

The Python library Beautiful Soup is a popular tool for web scraping and extracting data from HTML and XML files. While the installation process is straightforward for most users, there are some nuances to be aware of when setting up Beautiful Soup on your system.


Before installing Beautiful Soup, make sure you have Python and pip installed on your system. Beautiful Soup 4, the latest major version, requires Python 2.7 or Python 3.x.

To check your Python version, run:

python --version

And to check if pip is installed, run:

pip --version

If either Python or pip are missing, you'll need to install them first before proceeding with Beautiful Soup.


Once Python and pip are ready, you can install Beautiful Soup via pip:

pip install beautifulsoup4

This will download and install the latest stable release of Beautiful Soup 4 from the Python Package Index.

However, it's considered best practice to install Beautiful Soup in a virtual environment to avoid modifying system-wide packages. To create a virtual env:

python -m venv env

Activate the environment:

source env/bin/activate (Linux/MacOS)
env\\Scripts\\activate (Windows)

Then install Beautiful Soup while the virtual env is active:

pip install beautifulsoup4

Now Beautiful Soup is isolated in the virtual environment.


Beautiful Soup depends on the lxml and/or html5lib parsers for parsing XML and HTML. The installation via pip should automatically install these dependencies.

However, if for some reason they are missing, you may need to explicitly install them:

pip install lxml
pip install html5lib

Make sure to install any missing dependencies before trying to run Beautiful Soup.

Version Mismatch Issues

Sometimes you may run into an issue where multiple versions of Beautiful Soup are installed in different environments. This can cause confusion and unexpected errors.

To check your currently installed version:

pip show beautifulsoup4

If the version is incorrect or outdated, uninstall it:

pip uninstall beautifulsoup4

Then reinstall the correct version in the proper environment.

Virtual environments are useful here to isolate the desired version of Beautiful Soup and its dependencies.


While installing Beautiful Soup through pip is relatively quick, issues like dependencies and environment confusion can crop up. Using virtual environments and explicitly installing any missing lxml and html5lib parsers can help avoid headaches down the road. Carefully managing your environments and versions will ensure Beautiful Soup is set up properly.

Browse by tags:

Browse by language:

The easiest way to do Web Scraping

Get HTML from any page with a simple API call. We handle proxy rotation, browser identities, automatic retries, CAPTCHAs, JavaScript rendering, etc automatically for you

Try ProxiesAPI for free

curl ""

<!doctype html>
    <title>Example Domain</title>
    <meta charset="utf-8" />
    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />


Don't leave just yet!

Enter your email below to claim your free API key: