We don't publish
your competitive advantage.

IFImporting LangChain (e.g., `from langchain.schema import AIMessage`) with Python 3.12.4 and pydantic 2.7.3 fails with TypeError: ForwardRef._evaluate() missing 1 required keyword-only argument: 'recursive_guard'.

THENUpgrade pydantic to version 2.7.4 or later, or downgrade Python to 3.12.3. This fixes the incompatibility between Python 3.12.4 and pydantic v1 (bundled within pydantic 2.7.3) that causes the import error.

IFLangChain installation or build fails on Python 3.12 due to dependencies like aiohttp and tensorflow-text not yet supporting Python 3.12.

THENDowngrade to Python 3.11, which is fully supported by LangChain and all its dependencies. Use a Docker image like python:3.11-slim or set the Python version in your environment to 3.11. This ensures pip install langchain completes successfully.

IFUsing langfuse with Python 3.14 causes a Pydantic v1 ConfigError when initializing Langfuse.

THENUpgrade langfuse to a version that uses Pydantic v2 (when available), or pin Python version below 3.14. For now, downgrade to Python 3.12 or earlier, as Pydantic v1 is incompatible with Python 3.14. Monitor langfuse releases for a fix.

IFImporting langchain fails with TypeError: ForwardRef._evaluate() missing 1 required keyword-only argument: 'recursive_guard' when using Python 3.12.4 and pydantic==2.7.3.

THENDowngrade Python to 3.12.3 or upgrade pydantic to a version that fixes the ForwardRef._evaluate() incompatibility (e.g., pydantic 2.7.4 or later). This ensures langchain imports function correctly.

IFWhen using Langfuse SDK with Python 3.14, imports fail due to pydantic v1 incompatibility.

THENUpgrade Langfuse to use pydantic v2 or later. If unavailable, pin Python version below 3.14 or switch to an alternative observability SDK.

IFAttempting to install Open WebUI using `pip install` with a Python version other than 3.11 results in compatibility errors.

THENEnsure the system Python is version 3.11 before installation. Use a Python version manager like `pyenv` or a virtual environment to isolate the correct runtime.

IFWhen using transformers 4.46.0 on Python 3.8, importing `transformers.pipelines.audio_utils` fails with `TypeError: 'type' object is not subscriptable` due to use of `list[str]` type hint.

THENEnsure Python version is 3.9 or later, or add `from __future__ import annotations` at the top of the affected file (e.g., `audio_utils.py`) to enable forward references for type hints in Python 3.8. Alternatively, replace `list[str]` with `List[str]` from the `typing` module.

IFPoetry install fails with error: 'llama-index requires Python >=3.8.1,<3.12' and the project's Python range is incompatible.

THENUpdate the `python` field in your `pyproject.toml` to a range that falls within llama-index's requirement (e.g., `python = ">=3.10,<3.12"`). Then run `poetry lock --no-update`, `poetry install`, and finally `poetry add llama-index@latest`.

IFInstalling langchain on Python 3.12 fails because aiohttp and other dependencies do not support Python 3.12.

THENUse Python 3.11 or lower until langchain's dependencies are updated to support Python 3.12. Alternatively, install langchain with minimal dependencies and manually resolve incompatible packages.

IFLangChain installation fails on Python 3.12 with errors building wheels for aiohttp and other dependencies.

THENDowngrade to Python 3.11 or earlier. For Docker, use the `python:3.11` base image to ensure all dependencies are supported.

IFImporting from transformers.pipelines.audio_utils on Python 3.8 with transformers 4.46.0 raises TypeError: 'type' object is not subscriptable because the file uses `list[str]` type hints without the required `from __future__ import annotations`.

THENAdd `from __future__ import annotations` at the top of `src/transformers/pipelines/audio_utils.py` to enable forward-compatible type hints on Python 3.8. Alternatively, replace `list[str]` with `List[str]` imported from the `typing` module, or upgrade to a patched release (>=4.46.1).

IFUsing langfuse SDK with Python 3.14 causes a ConfigError because the SDK depends on Pydantic v1, which is incompatible with Python 3.14.

THENPin your Python runtime to version ≤3.13 until langfuse releases an SDK version that supports Pydantic v2. Alternatively, ensure that your environment uses a Python version prior to 3.14. Check for SDK updates that migrate to Pydantic v2.