Skip to content

Conversation

@NihalShinde4933
Copy link
Contributor

Summary

This PR updates docs/getting_started.rst to:

  • Clarify that Python 3.9 is required for development.
  • Recommend using WSL instead of native Windows for Kolibri development.

Motivation

During setup, I encountered issues due to:

  • pre-commit needing Python 3.9+ (not mentioned explicitly).

  • Running Kolibri directly on Windows (unsupported as per maintainers).

This documentation improvement aims to save new contributors from similar issues.

Related Issue

Closes #13458

Notes

  • Fixed CRLF to LF line endings to avoid whole-file diffs.
  • Re-submission after feedback on previous PR.

Screenshots / Changes

Screenshot (60)-fotor-20250606135614

@github-actions
Copy link
Contributor

github-actions bot commented Jun 9, 2025

Copy link
Member

@rtibbles rtibbles left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple of other stale references that need to be updated.

To develop on Kolibri, you'll need:

* Python 3.6+ (Kolibri doesn't currently support Python 3.12.0 or higher)
* Python 3.9 or higher (Note: Kolibri does not yet support Python 3.12 or above)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be updated to Python 3.14 or above


To install pyenv see the detailed instructions here :doc:`/howtos/installing_pyenv`.
..note::
If you are using a package manager, make sure to install a Python version compatible with Kolibri (3.9 or above, but below 3.12). If you're using `pyenv`, you can install it with a command like `pyenv install 3.9.9`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

but below 3.14

@MisRob
Copy link
Member

MisRob commented Jun 30, 2025

Hi @NihalShinde4933, do you plan to address feedback?

Copy link
Member

@AlexVelezLl AlexVelezLl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rtibbles rtibbles dismissed their stale review July 28, 2025 20:01

Changes addressed.

@rtibbles rtibbles merged commit 9a614a4 into learningequality:develop Jul 28, 2025
57 checks passed
AllanOXDi pushed a commit to AllanOXDi/kolibri that referenced this pull request Aug 6, 2025
…ty#13463)

* Clarify Python version and WSL requirement in docs

* Update max Python version in getting started docs.

---------

Co-authored-by: Richard Tibbles <richard@learningequality.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

🚫 Setup Error: pre-commit==3.8.0 Not Found During pip install -r requirements/dev.txt

4 participants