{"id":21009,"library":"breadability","title":"Breadability","description":"A Python port of the Readability HTML parser (originally by Arc90) for extracting readable content from HTML pages. Current version: 0.1.20. The library is in maintenance mode with infrequent releases.","status":"maintenance","version":"0.1.20","language":"python","source_language":"en","source_url":"https://github.com/bookieio/breadability","tags":["readability","content-extraction","html-parser","maintenance"],"install":[{"cmd":"pip install breadability","lang":"bash","label":"Default install"}],"dependencies":[],"imports":[{"note":"Article is in the readable submodule","wrong":"from breadability import Article","symbol":"readable","correct":"from breadability.readable import Article"},{"note":"function is in readable submodule","wrong":"from breadability import readability_filter","symbol":"readable","correct":"from breadability.readable import readability_filter"}],"quickstart":{"code":"import requests\nfrom breadability.readable import Article\n\nurl = 'https://example.com/article'\nresponse = requests.get(url)\narticle = Article(response.text)\nprint(article.title)\nprint(article.content)","lang":"python","description":"Fetch a URL and extract the readable article content."},"warnings":[{"fix":"Switch to readability-lxml (pip install readability-lxml) or trafilatura for better maintained alternatives.","message":"The library is no longer actively maintained; consider using readability-lxml or trafilatura instead.","severity":"deprecated","affected_versions":"all"},{"fix":"Use 'from breadability.readable import Article'.","message":"Import paths differ from many tutorials. The main class 'Article' is in the 'breadability.readable' submodule, not directly in 'breadability'.","severity":"gotcha","affected_versions":"all"},{"fix":"Use requests.get(url).text to get the HTML, then pass to Article().","message":"The library expects HTML string input, not a URL. You must fetch the page yourself (e.g., with requests).","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run: pip install breadability","cause":"Library not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'breadability'"},{"fix":"Use: from breadability.readable import Article","cause":"Trying to import from wrong path; breadability is a package, not a module.","error":"AttributeError: module 'breadability' has no attribute 'readable'"},{"fix":"Fetch HTML first: article = Article(requests.get(url).text)","cause":"Passing URL instead of HTML string to Article constructor.","error":"TypeError: __init__() takes 1 positional argument but 2 were given"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}