bs4.exceptions.featurenotfound: couldn't find a tree builder with the features you requested: xml

Not specified by the original author.

BeautifulSoup does not ship its own HTML parser. When you write BeautifulSoup(html, 'lxml') and lxml is not installed, you get FeatureNotFound instead of a soup. Install it with pip install lxml and the same line works. If you cannot install lxml, switch the second argument to 'html.parser' (built into Python, no install needed) and move on.

The error

bs4.FeatureNotFound: Couldn't find a tree builder with the features you requested: lxml

Fix it

1. Install lxml

pip install lxml

Expected: pip reports Successfully installed lxml-....

2. Re-run your parse line unchanged

python -c "from bs4 import BeautifulSoup; print(BeautifulSoup('hi', 'lxml').get_text())"

Expected: it prints hi. The line that raised now works because the requested tree builder exists.

3. Alternative when you cannot install anything

Change the parser argument to the built-in one:

soup = BeautifulSoup(html, 'html.parser')

Expected: parsing works with no new installs. Slightly slower and more lenient than lxml, fine for most scraping.

When this applies

• the traceback is bs4.FeatureNotFound and names lxml
• you passed 'lxml', 'lxml-xml', or 'xml' as the parser argument
• a library you use (pandas read_html, for example) asks for lxml under the hood

When it does NOT apply

• ModuleNotFoundError: No module named 'bs4' is a different problem (install beautifulsoup4)
• FeatureNotFound naming html5lib means install html5lib instead
• an ImportError on the BeautifulSoup name is the stub/shadowing problem

Compatibility

All beautifulsoup4 4.x versions. lxml wheels exist for CPython 3.8+ on Windows, macOS, and Linux; on odd platforms you may need the libxml2 system libraries to build it.

Variant phrasings

Couldn't find a tree builder with the features you requested: html5lib

Same error, different parser. Fix is pip install html5lib, or switch to 'html.parser'.

Couldn't find a tree builder with the features you requested: lxml-xml

You asked for the XML tree builder. Same fix: pip install lxml.

Why it happens

BeautifulSoup is a tree API, not a parser. The second argument to the constructor picks which installed parsing library does the actual work. If that library is not installed, BeautifulSoup cannot build the tree and raises FeatureNotFound. The message names exactly the feature set it looked for, so the fix is installing the named parser or picking one you have.

Edge cases

• In a venv, make sure you pip-install into the same environment that runs the script.
• On Alpine/musl Linux there is no lxml wheel, so pip builds from source and needs libxml2-dev and libxslt-dev system packages.
• If lxml is installed but the error persists, you have two Pythons and installed into the wrong one. python -m pip install lxml targets the interpreter you run.

Stack Overflow question 24398302 is the canonical thread for this exact FeatureNotFound string: the asker passed 'lxml' without having lxml installed, and the accepted answer is pip install lxml (with apt-get install of the XML dev libraries on Linux where no wheel applied). The same string recurs in project trackers such as nsepy#238 with the same resolution. Source: https://stackoverflow.com/questions/24398302

Not specified by the original author.

You asked BeautifulSoup for the html5lib parser (BeautifulSoup(html, 'html5lib')) without having html5lib installed. Run pip install html5lib and the same line works. If you cannot install it, switch to 'html.parser', which ships with Python.

The error

bs4.FeatureNotFound: Couldn't find a tree builder with the features you requested: html5lib

Fix it

1. Install html5lib

python -m pip install html5lib

Expected: Successfully installed html5lib-1.1.

2. Re-run your parse line unchanged

python -c "from bs4 import BeautifulSoup; print(BeautifulSoup('hi', 'html5lib').get_text())"

Expected: prints hi.

3. Alternative without new installs

soup = BeautifulSoup(html, 'html.parser')

Expected: parses with the stdlib parser. Behavior differs slightly on broken markup, which is the whole reason people pick html5lib.

When this applies

• the FeatureNotFound message names html5lib
• you passed 'html5lib' as the parser, or a library did on your behalf

When it does NOT apply

• FeatureNotFound naming lxml means install lxml instead
• No module named 'html5lib' from a direct import is the same missing package without bs4 in the middle

Compatibility

All bs4 4.x with html5lib 1.1. html5lib is the most lenient parser bs4 supports, which is why guides recommend it.

Why it happens

BeautifulSoup is a tree API over pluggable parsers. Naming 'html5lib' selects that parser, and if it is not installed bs4 raises FeatureNotFound instead of guessing. The message names the missing feature set, so the fix is mechanical.

Edge cases

• html5lib is slower than lxml. Pick it for leniency on broken markup, not for speed.
• If html5lib IS installed but the error persists, it is the two-interpreter problem. python -m pip install html5lib targets the right one.

Stack Overflow 24398302 is the canonical thread for the FeatureNotFound family: asking bs4 for a parser that is not installed raises it, and the accepted fix is installing the named parser (lxml in the question's case, html5lib in this variant). The html5lib variant is reported with the same resolution everywhere it appears. Source: https://stackoverflow.com/questions/24398302

Not specified by the original author.

Short answer: install the beautifulsoup4 distribution (not a package called bs4) into the same interpreter that runs your code. `` ModuleNotFoundError: No module named 'bs4' 1. Run python -m pip install beautifulsoup4. Using python -m pip guarantees the package lands in the interpreter you actually run. Expected: install completes and lists beautifulsoup4 plus soupsieve. 2. Verify with python -c "from bs4 import BeautifulSoup; print('ok')". Expected: ok. 3. If it still fails, compare interpreters: python -c "import sys; print(sys.executable)" and python -m pip --version should point at the same environment. In a virtualenv, activate it before installing. In an IDE, select that same interpreter as the project interpreter. 4. Avoid the trap package: pip install bs4 installs a tiny placeholder distribution that does not provide BeautifulSoup. If you installed it by mistake, run python -m pip uninstall bs4` and then repeat step 1. Root cause: bs4 is not part of the standard library and was never installed for this interpreter, or it was installed for a different one. The import name being shorter than the distribution name is what sends people to the wrong install command. When to use: fresh environments, CI images, new virtualenvs, Jupyter kernels pointing at another env. When NOT to use: if the import works but parsing fails with a FeatureNotFound tree-builder error, that is a missing parser (lxml or html5lib), not a missing bs4. Variant phrasings: "no module named bs4", "from bs4 import beautifulsoup error", "import bs4 could not be resolved". Edge cases: on Debian/Ubuntu the system package is python3-bs4 if you must use apt. In Jupyter, install with the notebook kernel's interpreter or restart the kernel after installing. Check there is no local file named bs4.py shadowing the package.

Context: The import name and the install name differ here, and that mismatch is the whole problem. Code imports the bs4 module, but the PyPI distribution that provides it is called beautifulsoup4. On top of that, pip often installs into a different interpreter than the one running the script, especially with several Pythons, a virtualenv, or an IDE with its own interpreter setting. The error means the running interpreter has no bs4 in its site-packages at all.

Source: The import name and the install name differ here, and that mismatch is the whole problem. Code imports the bs4 module, but the PyPI distribution that provides it is called beautifulsoup4. On top of that, pip often installs into a different interpreter than the one running the script, especially with several Pythons, a virtualenv, or an IDE with its own interpreter setting. The error means the running interpreter has no bs4 in its site-packages at all.

Verified resolution: Short answer: install the beautifulsoup4 distribution (not a package called bs4) into the same interpreter that runs your code. `` ModuleNotFoundError: No module named 'bs4' 1. Run python -m pip install beautifulsoup4. Using python -m pip guarantees the package lands in the interpreter you actually run. Expected: install completes and lists beautifulsoup4 plus soupsieve. 2. Verify with python -c "from bs4 import BeautifulSoup; print('ok')". Expected: ok. 3. If it still fails, compare interpreters: python -c "import sys; print(sys.executable)" and python -m pip --version should point at the same environment. In a virtualenv, activate it before installing. In an IDE, select that same interpreter as the project interpreter. 4. Avoid the trap package: pip install bs4 installs a tiny placeholder distribution that does not provide BeautifulSoup. If you installed it by mistake, run python -m pip uninstall bs4` and then repeat step 1. Root cause: bs4 is not part of the standard library and was never installed for this interpreter, or it was installed for a different one. The import name being shorter than the distribution name is what sends people to the wrong install command. When to use: fresh environments, CI images, new virtualenvs, Jupyter kernels pointing at another env. When NOT to use: if the import works but parsing fails with a FeatureNotFound tree-builder error, that is a missing parser (lxml or html5lib), not a missing bs4. Variant phrasings: "no module named bs4", "from bs4 import beautifulsoup error", "import bs4 could not be resolved". Edge cases: on Debian/Ubuntu the system package is python3-bs4 if you must use apt. In Jupyter, install with the notebook kernel's interpreter or restart the kernel after installing. Check there is no local file named bs4.py shadowing the package.

Source URL: https://bobbyhadz.com/blog/python-no-module-named-bs4