ModuleNotFoundError: No module named 'transformers.agents'

[qusma]

Hi, just cloned the repo and I'm trying to run it on Windows 11. Installation with the script looks like it goes well until it tries to run, when it fails with a ModuleNotFoundError. Full log:

.\run_windows.bat
Creating virtual environment
Existing venv detected. Activating.
Activating virtual environment
---------------------------------------------------------------
Installing python requirements from requirements.txt
Requirement already satisfied: uvicorn~=0.34.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from -r requirements.txt (line 1)) (0.34.3)
Requirement already satisfied: fastapi~=0.115.12 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from -r requirements.txt (line 2)) (0.115.13)
Requirement already satisfied: datasets~=3.5.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from -r requirements.txt (line 3)) (3.5.1)
Requirement already satisfied: txtai~=8.4.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from -r requirements.txt (line 4)) (8.4.0)
Requirement already satisfied: colorama~=0.4.6 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from -r requirements.txt (line 5)) (0.4.6)
Requirement already satisfied: numpy<2.0.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from -r requirements.txt (line 6)) (1.26.4)
Requirement already satisfied: accelerate~=1.6.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from -r requirements.txt (line 7)) (1.6.0)
Requirement already satisfied: click>=7.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from uvicorn~=0.34.0->-r requirements.txt (line 1)) (8.2.1)
Requirement already satisfied: h11>=0.8 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from uvicorn~=0.34.0->-r requirements.txt (line 1)) (0.16.0)
Requirement already satisfied: starlette<0.47.0,>=0.40.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from fastapi~=0.115.12->-r requirements.txt (line 2)) (0.46.2)
Requirement already satisfied: pydantic!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0,>=1.7.4 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from fastapi~=0.115.12->-r requirements.txt (line 2)) (2.11.7)
Requirement already satisfied: typing-extensions>=4.8.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from fastapi~=0.115.12->-r requirements.txt (line 2)) (4.14.0)
Requirement already satisfied: filelock in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (3.18.0)
Requirement already satisfied: pyarrow>=15.0.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (20.0.0)
Requirement already satisfied: dill<0.3.9,>=0.3.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (0.3.8)
Requirement already satisfied: pandas in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (2.3.0)
Requirement already satisfied: requests>=2.32.2 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (2.32.4)
Requirement already satisfied: tqdm>=4.66.3 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (4.67.1)
Requirement already satisfied: xxhash in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (3.5.0)
Requirement already satisfied: multiprocess<0.70.17 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (0.70.16)
Requirement already satisfied: fsspec<=2025.3.0,>=2023.1.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from fsspec[http]<=2025.3.0,>=2023.1.0->datasets~=3.5.0->-r requirements.txt (line 3)) (2025.3.0)
Requirement already satisfied: aiohttp in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (3.12.13)
Requirement already satisfied: huggingface-hub>=0.24.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (0.33.0)
Requirement already satisfied: packaging in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (25.0)
Requirement already satisfied: pyyaml>=5.1 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from datasets~=3.5.0->-r requirements.txt (line 3)) (6.0.2)
Requirement already satisfied: faiss-cpu>=1.7.1.post2 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from txtai~=8.4.0->-r requirements.txt (line 4)) (1.11.0)
Requirement already satisfied: msgpack>=1.0.7 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from txtai~=8.4.0->-r requirements.txt (line 4)) (1.1.1)
Requirement already satisfied: torch>=1.12.1 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from txtai~=8.4.0->-r requirements.txt (line 4)) (2.7.1)
Requirement already satisfied: transformers>=4.45.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from txtai~=8.4.0->-r requirements.txt (line 4)) (4.52.4)
Requirement already satisfied: regex>=2022.8.17 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from txtai~=8.4.0->-r requirements.txt (line 4)) (2024.11.6)
Requirement already satisfied: psutil in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from accelerate~=1.6.0->-r requirements.txt (line 7)) (7.0.0)
Requirement already satisfied: safetensors>=0.4.3 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from accelerate~=1.6.0->-r requirements.txt (line 7)) (0.5.3)
Requirement already satisfied: aiohappyeyeballs>=2.5.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from aiohttp->datasets~=3.5.0->-r requirements.txt (line 3)) (2.6.1)
Requirement already satisfied: aiosignal>=1.1.2 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from aiohttp->datasets~=3.5.0->-r requirements.txt (line 3)) (1.3.2)
Requirement already satisfied: attrs>=17.3.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from aiohttp->datasets~=3.5.0->-r requirements.txt (line 3)) (25.3.0)
Requirement already satisfied: frozenlist>=1.1.1 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from aiohttp->datasets~=3.5.0->-r requirements.txt (line 3)) (1.7.0)
Requirement already satisfied: multidict<7.0,>=4.5 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from aiohttp->datasets~=3.5.0->-r requirements.txt (line 3)) (6.5.0)
Requirement already satisfied: propcache>=0.2.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from aiohttp->datasets~=3.5.0->-r requirements.txt (line 3)) (0.3.2)
Requirement already satisfied: yarl<2.0,>=1.17.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from aiohttp->datasets~=3.5.0->-r requirements.txt (line 3)) (1.20.1)
Requirement already satisfied: annotated-types>=0.6.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from pydantic!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0,>=1.7.4->fastapi~=0.115.12->-r requirements.txt (line 2)) (0.7.0)
Requirement already satisfied: pydantic-core==2.33.2 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from pydantic!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0,>=1.7.4->fastapi~=0.115.12->-r requirements.txt (line 2)) (2.33.2)
Requirement already satisfied: typing-inspection>=0.4.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from pydantic!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0,>=1.7.4->fastapi~=0.115.12->-r requirements.txt (line 2)) (0.4.1)
Requirement already satisfied: charset_normalizer<4,>=2 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from requests>=2.32.2->datasets~=3.5.0->-r requirements.txt (line 3)) (3.4.2)
Requirement already satisfied: idna<4,>=2.5 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from requests>=2.32.2->datasets~=3.5.0->-r requirements.txt (line 3)) (3.10)
Requirement already satisfied: urllib3<3,>=1.21.1 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from requests>=2.32.2->datasets~=3.5.0->-r requirements.txt (line 3)) (2.4.0)
Requirement already satisfied: certifi>=2017.4.17 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from requests>=2.32.2->datasets~=3.5.0->-r requirements.txt (line 3)) (2025.6.15)
Requirement already satisfied: anyio<5,>=3.6.2 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from starlette<0.47.0,>=0.40.0->fastapi~=0.115.12->-r requirements.txt (line 2)) (4.9.0)
Requirement already satisfied: sympy>=1.13.3 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from torch>=1.12.1->txtai~=8.4.0->-r requirements.txt (line 4)) (1.14.0)
Requirement already satisfied: networkx in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from torch>=1.12.1->txtai~=8.4.0->-r requirements.txt (line 4)) (3.5)
Requirement already satisfied: jinja2 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from torch>=1.12.1->txtai~=8.4.0->-r requirements.txt (line 4)) (3.1.6)
Requirement already satisfied: setuptools in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from torch>=1.12.1->txtai~=8.4.0->-r requirements.txt (line 4)) (80.9.0)
Requirement already satisfied: tokenizers<0.22,>=0.21 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from transformers>=4.45.0->txtai~=8.4.0->-r requirements.txt (line 4)) (0.21.1)
Requirement already satisfied: python-dateutil>=2.8.2 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from pandas->datasets~=3.5.0->-r requirements.txt (line 3)) (2.9.0.post0)
Requirement already satisfied: pytz>=2020.1 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from pandas->datasets~=3.5.0->-r requirements.txt (line 3)) (2025.2)
Requirement already satisfied: tzdata>=2022.7 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from pandas->datasets~=3.5.0->-r requirements.txt (line 3)) (2025.2)
Requirement already satisfied: sniffio>=1.1 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from anyio<5,>=3.6.2->starlette<0.47.0,>=0.40.0->fastapi~=0.115.12->-r requirements.txt (line 2)) (1.3.1)
Requirement already satisfied: six>=1.5 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from python-dateutil>=2.8.2->pandas->datasets~=3.5.0->-r requirements.txt (line 3)) (1.17.0)
Requirement already satisfied: mpmath<1.4,>=1.1.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from sympy>=1.13.3->torch>=1.12.1->txtai~=8.4.0->-r requirements.txt (line 4)) (1.3.0)
Requirement already satisfied: MarkupSafe>=2.0 in c:\users\alex\documents\code\offlinewikipediatextapi\venv\lib\site-packages (from jinja2->torch>=1.12.1->txtai~=8.4.0->-r requirements.txt (line 4)) (3.0.2)

[notice] A new release of pip is available: 25.0.1 -> 25.1.1
[notice] To update, run: python.exe -m pip install --upgrade pip
---------------------------------------------------------------
Downloading Wikipedia dataset. As of 2024-11-14, this is about 44GB
Existing wiki-dataset directory detected.
---------------------------------------------------------------
Downloading txtai-wikipedia dataset. As of 2024-11-14, this is about 15GB.
Existing txtai-wikipedia directory detected.
---------------------------------------------------------------
Starting API. If this is the first run, setup may take 10-15 minutes depending on your machine.
Setup time is due to indexing Wikipedia article titles into a json file for API speed.
---------------------------------------------------------------
API Starting...
Traceback (most recent call last):
  File "C:\Users\Alex\Documents\Code\OfflineWikipediaTextApi\start_api.py", line 11, in <module>
    from txtai.embeddings import Embeddings
  File "C:\Users\Alex\Documents\Code\OfflineWikipediaTextApi\venv\Lib\site-packages\txtai\__init__.py", line 8, in <module>
    from .agent import Agent
  File "C:\Users\Alex\Documents\Code\OfflineWikipediaTextApi\venv\Lib\site-packages\txtai\agent\__init__.py", line 5, in <module>
    from .base import Agent
  File "C:\Users\Alex\Documents\Code\OfflineWikipediaTextApi\venv\Lib\site-packages\txtai\agent\base.py", line 5, in <module>
    from .factory import ProcessFactory
  File "C:\Users\Alex\Documents\Code\OfflineWikipediaTextApi\venv\Lib\site-packages\txtai\agent\factory.py", line 5, in <module>
    from transformers.agents import CodeAgent, ReactCodeAgent, ReactJsonAgent
ModuleNotFoundError: No module named 'transformers.agents'

[davidmezzetti]

Recent versions of transformers deprecated the transformers.agents package. You can either install a later version of txtai or install an earlier version of transformers.

[SomeOddCodeGuy]

Sorry for the delay on this one! Requirements packages are updated. Also grabbed the latest NeuML wikipedia datasets! Huge thanks to @davidmezzetti for all the hard work on all this stuff.