Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document required Python 3.11.9 version #31

Open
bmerkle opened this issue Aug 31, 2024 · 0 comments
Open

Document required Python 3.11.9 version #31

bmerkle opened this issue Aug 31, 2024 · 0 comments

Comments

@bmerkle
Copy link

bmerkle commented Aug 31, 2024

Please provide us with the following information:

This issue is for a: (mark with an x)

- [x] bug report -> please search issues before submitting
- [ ] feature request
- [x] documentation issue or request
- [ ] regression (a behavior that used to work and stopped in a new release)

Minimal steps to reproduce

I had the newest version Python 3.12 installed on my machine and build the example.
Building runs fine (pip etc) but running the example fails with obscure errors.
I found out that the "az" tool seems not to be supported with Python 3.12

So I searched the docs from the rag-data-openai-python-promptflow example, and found hints about Python 3.10
However this did not run either..."az" gave a kind of error message that 3.11.9 is needed.

Finally I installed Python 3.11.9 and the example can be build and run successfully.
I would recommend to add this information into the docs as it can save some frustration.
I now noticed that the Windows AppStore has also Python 3.11.9 as default (which can avoid the problem if you install from there) but there are also other installation ways or OS, so giving a hint that Python 3.11.9 is required would be fine.

There are also ways to enforce the python version technically (e.g. via pipenv) but this would be a separate discussion.

Any log messages given by the failure

I can add the error messages with Python 3.12 and Python 3.10 if you need them

Expected/desired behavior

I would like the required Python version 3.11.9 to be documented clearly.

OS and Version?

Windows 7, 8 or 10. Linux (which distribution). macOS (Yosemite? El Capitan? Sierra?)
Windows

Versions

10

Mention any other details that might be useful


Thanks! We'll be in touch soon.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant