[Bug]: Not Compatible with Python 3.14 (lxml dependency failure)
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 3/5
- 見積もり時間
- 1〜2日
- 初心者へのやさしさ
- 52/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
- 技術スタック
- python
- 領域
- build-system
調査の方向性
Start by reproducing the Windows 11/Python 3.14 installation with the current dependency metadata and verify the lxml version resolution. Inspect the project’s package metadata and Python-version classifiers, then compare installation behavior with lxml 5.4.0 and 6.0.2. Done means Python 3.14 installs successfully or is rejected with a clear support message, with existing supported versions unaffected.
索引モデルが issue の本文から書いたものです。
説明
crawl4ai version
0.8.6
Summary
Crawl4AI installation fails in Python 3.14 environment due to lxml~=5.3.
Using lxml 6.0.2 works!
AI Analysis
pip install crawl4ai fails on Windows with Python 3.14 due to lxml~=5.3 source build error
Body
Describe the bug
Installing crawl4ai on Windows with Python 3.14 fails during dependency installation when pip tries to build lxml from source.
The failure appears related to Crawl4AI depending on lxml~=5.3, which resolves to lxml 5.4.0 in my environment. On Windows + Python 3.14, pip does not appear to find a compatible wheel and falls back to a native source build, which then fails because libxml2 headers/libraries are not available.
To Reproduce
- On Windows, create a fresh virtual environment with Python 3.14
- Run:
pip install crawl4ai
- Installation fails while building
lxml
Expected behavior
pip install crawl4ai should either:
- install successfully on Python 3.14, or
- fail early with a clear message that Python 3.14 is not currently supported
Actual behavior
Installation fails while building lxml from source.
Error output
Building wheels for collected packages: lxml
Building wheel for lxml (pyproject.toml) ... error
error: subprocess-exited-with-error
× Building wheel for lxml (pyproject.toml) did not run successfully.
│ exit code: 1
...
fatal error C1083: Cannot open include file: 'libxml/xmlversion.h': No such file or directory
Compile failed: command '...\\cl.exe' failed with exit code 2
...
fatal error C1083: Cannot open include file: 'libxml/xpath.h': No such file or directory
*********************************************************************************
Could not find function xmlXPathInit in library libxml2. Is libxml2 installed?
Is your C compiler installed and configured correctly?
*********************************************************************************
ERROR: Failed building wheel for lxml
Failed to build lxml
error: failed-wheel-build-for-install
× Failed to build installable wheels for some pyproject.toml based projects
╰─> lxml
Environment
- OS: Windows 11
- Python: 3.14.2
- pip: latest available at time of test
- Compiler/tooling: Visual Studio 2022 C++ tools detected in build log
Additional context
Current Crawl4AI PyPI metadata appears to declare:
Requires-Python: >=3.10- Python classifiers for:
- 3.10
- 3.11
- 3.12
- 3.13
But not 3.14.
Current dependency metadata also includes:
lxml~=5.3
So this may be a Python 3.14 compatibility gap caused by the current lxml version range, rather than a general Windows install problem.
Suggested fix
Possible options:
- Explicitly document that Python 3.14 is not yet supported
- Add a clearer install-time guard or message for unsupported Python versions
- Relax/update the
lxmldependency if a newer version line works with Python 3.14 - Document a recommended Python version such as 3.12 or 3.13 for Windows users
Workaround
Using Python 3.12 or 3.13 appears to be the safest workaround.
Current Behavior
Installation fails with error.
Is this reproducible?
Yes
OS
Windows
Python version
3.14
Browser
No response
Browser version
No response
Error logs & Screenshots (if applicable)
No response
- 主要言語
- Python
- スター
- 84.5k
- フォーク
- 8.7k
- 平均マージ
- 3日 20時間
- マージ済み PR（30日）
- 15
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
unclecode/crawl4ai のほかの issue
-
🐞 Bug 🩺 Needs Triage
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
unclecode/crawl4ai#2319 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
[Bug]: Reusing BFSDeepCrawlStrategy leaks the previous crawl's max_pages budget into a fresh runオープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
unclecode/crawl4ai#2309 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 84/100
unclecode/crawl4ai#2147 · コメント 3 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
unclecode/crawl4ai#2123 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
🐞 Bug 🩺 Needs Triage
難易度 4/5 3〜5日 初心者へのやさしさ 55/100
メンテナーはふだん 1 日以内に返信
unclecode/crawl4ai の issue をすべて見る
似ている issue
-
repo-audit
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
scverse/repo-health#20 ·
メンテナーはふだん 1 日以内に返信
-
/context/prime scope override double-prefixes an entity-ref project and drops its scoped memoriesオープン
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
phasespace-labs/palinode#232 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
collective/icalendar#1858 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
メンテナーはふだん 1 日以内に返信
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
langflow-ai/langflow#15496 ·
メンテナーはふだん 1 日以内に返信