[BUG] AttributeError: module 'cocoindex._engine' has no attribute 'set_settings_fn'

[sjj121]

Describe the bug
I just try an exampleexample with cocoindex==0.3.8, it can't work.

my depandecies
requires-python = ">=3.11"
dependencies = [
"aiohttp>=3.13.2",
"cocoindex[embeddings]==0.3.8",
"pgvector>=0.4.1",
"psycopg[binary,pool]>=3.2.9",
]

To Reproduce
Steps to reproduce the behavior:

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

CocoIndex Version
Which version of CocoIndex are you using?

Additional context
Add any other context about the problem here.

[sjj121]

D:\PycharmProjects\cocotest.venv\Scripts\python.exe D:\PycharmProjects\cocotest\main.py
Traceback (most recent call last):
File "D:\PycharmProjects\cocotest\main.py", line 1, in
import cocoindex
File "D:\PycharmProjects\cocotest.venv\Lib\site-packages\cocoindex_init_.py", line 6, in
from . import functions, sources, targets, cli, utils
File "D:\PycharmProjects\cocotest.venv\Lib\site-packages\cocoindex\cli.py", line 20, in
from . import flow, lib, setting
File "D:\PycharmProjects\cocotest.venv\Lib\site-packages\cocoindex\lib.py", line 22, in
_engine.set_settings_fn(lambda: prepare_settings(setting.Settings.from_env()))
^^^^^^^^^^^^^^^^^^^^^^^
AttributeError: module 'cocoindex._engine' has no attribute 'set_settings_fn'

[georgeh0]

Hi @sjj121, we tested in both Mac and Windows and cannot reproduce the problem.

Can you help provide more information:

• Can you share your specific Python version?
• Can you run the following command and provide the output?

  python -c 'import cocoindex._engine; print(dir(cocoindex._engine))'

Thanks!

[sjj121]

Hi @georgeh0 ,
Sorry for the delayed response. Thank you so much for your patience and for testing the issue on Mac and Windows.
Here’s the information you requested:

• My Python version is 3.11

python -V                                                          
Python 3.11.11

• Output of the command python -c 'import cocoindex._engine; print(dir(cocoindex._engine))':

python -c 'import cocoindex._engine; print(dir(cocoindex._engine))'
Traceback (most recent call last):
  File "<string>", line 1, in <module>
  File "D:\PycharmProjects\cocotest\.venv\Lib\site-packages\cocoindex\__init__.py", line 6, in <module>
    from . import functions, sources, targets, cli, utils
  File "D:\PycharmProjects\cocotest\.venv\Lib\site-packages\cocoindex\cli.py", line 20, in <module>
    from . import flow, lib, setting
  File "D:\PycharmProjects\cocotest\.venv\Lib\site-packages\cocoindex\lib.py", line 22, in <module>
    _engine.set_settings_fn(lambda: prepare_settings(setting.Settings.from_env()))
    ^^^^^^^^^^^^^^^^^^^^^^^
AttributeError: module 'cocoindex._engine' has no attribute 'set_settings_fn'

Interestingly, when I downgrade cocoindex to version 0.2.8, the code runs without any issues.

Please feel free to let me know if there’s any other context, environment details, or tests that would help you dig into this further.

[georgeh0]

Hi @sjj121, thanks for the info. Can you also provide your Windows version, and also system architecture (e.g. is it amd64/x86_64 or arm64)? Thanks!

[sjj121]

Hi @georgeh0 ,
Thanks for following up! Here's my Windows system information as requested:
OS Name: Microsoft Windows 10 Pro
OS Version: 10.0.19045 (Build 19045)
System Architecture: x86_64 (64-bit)
Let me know if you need any additional details to help troubleshoot the issue further!
Best regards

[georgeh0]

Hi @sjj121,

I suspect there's some version inconsistency between the Python code and Rust core for cocoindex you installed. cocoindex._engine is the module for our Rust core. set_settings_fn was introduced around v0.2.10. So if a new version of cocoindex Python code is using an older version of cocoindex._engine somehow, you'll see the problem.

I just created #1323 to automatically detect this type of version inconsistency issue at import time. A new release v0.3.10 is ongoing (may need up to 30 minutes), and please install cocoindex>=0.3.10 later, and it'll output error messages if it's due to version consistency.

Meanwhile, you can also run this to do a clean reinstall and have another try:

pip uninstall cocoindex
pip install --no-cache-dir cocoindex

Thanks!

[georgeh0]

Hi @sjj121,

The new version 0.3.10 has already been released. Please upgrade it and have another try - it'll provide more diagnostic information if it's indeed a version mismatch. Thanks!

[sjj121]

Hi @georgeh0 ,
Just a quick update, after doing a clean reinstall as you recommended, cocoindex is now working perfectly!
Regarding the root cause, I noticed that the _engine.pyd file wasn’t updated when I previously upgraded cocoindex. Based on your explanation about version inconsistency between the Python code and Rust core, this must have been the issue.
Thank you so much for your prompt help. I really appreciate your hard work on maintaining cocoindex — it’s been invaluable for my work.

[badmonster0]

Great @sjj121 ! thanks for reporting the issue and working with us closely resolving it.
We are so happy that CocoIndex is invaluable to your project and appreciate your feedback! :)

And thanks @georgeh0 :)