Installed hub validators import error.

[farzbood]

Hi,
I've installed the guardrails-ai 0.6.7 following the instructions in the documentation configure the package and install two validators (profanity_free, toxic_language) as instructed in the Sample App from the hub successfully, but running the code, raised the following Import error:

Traceback (most recent call last):
File "d:\pyprojects\LLMprjs\Haystack\guardrails-webui\simple_chat_guard.py", line 1, in
from guardrails import Guard, docs_utils
File "D:\pyprojects\LLMprjs\Haystack.venv\Lib\site-packages\guardrails_init_.py", line 12, in
from guardrails.hub.install import install
File "D:\pyprojects\LLMprjs\Haystack.venv\Lib\site-packages\guardrails\hub_init_.py", line 4, in
from guardrails_grhub_toxic_language import ToxicLanguage
ModuleNotFoundError: No module named 'guardrails_grhub_toxic_language'

My dev environment:

O.S: Win10 22H2 x86_64
Python: 3.13.9 (uv .venv)
IDE: VSCode Version: 1.105.1

Originally posted by @farzbood in #1305

[CalebCourier]

@farzbood This can happen for a number of reasons but the most common are:

1. When the installer (uv in this case) has a target directory that is different from where the core guardrails-ai package is installed. You can check this by verifying that the parent directories of pip, python, and guardrails are all the same using the where command on Windows (which on linux and MacOS)
2. The code is running in a Jupyter notebook, and the dependencies are installed via the command line without refreshing the kernel. In this case try refreshing the kernel.

If neither of these work, I would suggest trying a fresh virtual environment (e.g. python -m venv ./.venv) and using pip instead of uv because uv is not 100% compliant with the pip API.