Skip to content

docs(orion): add script compatibility note for Python version check#1582

Open
tangzz-radxa wants to merge 1 commit intoradxa-docs:mainfrom
tangzz-radxa:docs/fix-issue-1534-python-version
Open

docs(orion): add script compatibility note for Python version check#1582
tangzz-radxa wants to merge 1 commit intoradxa-docs:mainfrom
tangzz-radxa:docs/fix-issue-1534-python-version

Conversation

@tangzz-radxa
Copy link
Copy Markdown
Contributor

Summary

Adds a script compatibility note to the Orion O6/O6N AI environment setup page to address Python version check issues reported in #1534.

Why

Issue #1534 reports that the env_setup.sh script fails when users have Python 3.13.12 installed because the script checks for Python 3.10.x. The SDK is only compatible with Python 3.10, but the error message could be confusing for users with newer Python versions.

This PR adds a note explaining:

  • The env_setup.sh script checks for Python 3.10
  • The script may fail with newer Python versions (e.g., 3.13)
  • Two workarounds:
    1. Ensure using the correct Python 3.10 environment: conda activate noe
    2. Manual installation as fallback: pip install -r requirements.txt CixBuilder-6.1.3407.2-cp310-none-linux_x86_64.whl

Verification

  • The note appears in both Chinese and English versions of the page
  • Added after the bash env_setup.sh command in the "Use the script to set up the development environment" section
  • Uses the :::note[] admonition format consistent with other notes on the page
  • Provides clear, actionable instructions for users encountering the Python version check error

Fixes #1534

Fixes radxa-docs#1534

Add a note explaining that the env_setup.sh script checks for Python 3.10
and may fail with newer Python versions. Provide manual installation
instructions as a workaround.
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

Successfully merging this pull request may close these issues.

Issue from orion/o6/app-development/artificial-intelligence/env-setup

1 participant