ERROR: Package 'rotator-library' requires a different Python: 3.11.2 not in '>=3.12'

[hernanmd]

Branch

other (specify below)

Branch (if other)

Mirrowel

Version / Tag / Commit

No response

Provider(s) Affected

No response

Deployment Method

From source (python)

Operating System

Debian 13

Python Version (if running from source)

3.11.2

Bug Description

Complete output installation log:

_  ~ g clone git@github.com:Mirrowel/LLM-API-Key-Proxy.git
Cloning into 'LLM-API-Key-Proxy'...
remote: Enumerating objects: 9190, done.
remote: Counting objects: 100% (1728/1728), done.
remote: Compressing objects: 100% (182/182), done.
remote: Total 9190 (delta 1623), reused 1546 (delta 1546), pack-reused 7462 (from 3)
Receiving objects: 100% (9190/9190), 4.84 MiB | 4.27 MiB/s, done.
Resolving deltas: 100% (6200/6200), done.
_  ~ cd LLM-API-Key-Proxy
_  LLM-API-Key-Proxy git:(main) python3 -m venv venv
_  LLM-API-Key-Proxy git:(main) source venv/bin/activate
(venv) _  LLM-API-Key-Proxy git:(main) pip install -r requirements.txt
Looking in indexes: https://pypi.org/simple, https://www.piwheels.org/simple
Obtaining file:///home/mvs/LLM-API-Key-Proxy/src/rotator_library (from -r requirements.txt (line 9))
  Installing build dependencies ... done
  Checking if build backend supports build_editable ... done
  Getting requirements to build editable ... done
  Preparing editable metadata (pyproject.toml) ... done
Collecting fastapi
  Obtaining dependency information for fastapi from https://www.piwheels.org/simple/fastapi/fastapi-0.141.1-py3-none-any.whl.metadata
  Downloading https://www.piwheels.org/simple/fastapi/fastapi-0.141.1-py3-none-any.whl.metadata (27 kB)
Collecting uvicorn
  Obtaining dependency information for uvicorn from https://www.piwheels.org/simple/uvicorn/uvicorn-0.52.4-py3-none-any.whl.metadata
  Downloading https://www.piwheels.org/simple/uvicorn/uvicorn-0.52.4-py3-none-any.whl.metadata (6.6 kB)
Collecting python-dotenv
  Obtaining dependency information for python-dotenv from https://www.piwheels.org/simple/python-dotenv/python_dotenv-1.2.3-py3-none-any.whl.metadata
  Downloading https://www.piwheels.org/simple/python-dotenv/python_dotenv-1.2.3-py3-none-any.whl.metadata (29 kB)
Collecting litellm
  Downloading litellm-1.99.0-cp310-abi3-manylinux_2_28_aarch64.whl (23.1 MB)
     ──────────────────────────────────────── 23.1/23.1 MB 5.8 MB/s eta 0:00:00
Collecting filelock
  Obtaining dependency information for filelock from https://www.piwheels.org/simple/filelock/filelock-3.32.5-py3-none-any.whl.metadata
  Downloading https://www.piwheels.org/simple/filelock/filelock-3.32.5-py3-none-any.whl.metadata (2.0 kB)
Collecting httpx
  Obtaining dependency information for httpx from https://www.piwheels.org/simple/httpx/httpx-0.28.1-py3-none-any.whl.metadata
  Downloading https://www.piwheels.org/simple/httpx/httpx-0.28.1-py3-none-any.whl.metadata (7.1 kB)
Collecting aiofiles
  Obtaining dependency information for aiofiles from https://www.piwheels.org/simple/aiofiles/aiofiles-25.1.0-py3-none-any.whl.metadata
  Downloading https://www.piwheels.org/simple/aiofiles/aiofiles-25.1.0-py3-none-any.whl.metadata (6.3 kB)
Collecting aiohttp
  Downloading aiohttp-3.14.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (1.8 MB)
     ──────────────────────────────────────── 1.8/1.8 MB 3.8 MB/s eta 0:00:00
... truncated ...
  Downloading https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.6-py3-none-any.whl.metadata (12 kB)
  Obtaining dependency information for fastapi from https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.5-py3-none-any.whl.metadata
  Downloading https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.5-py3-none-any.whl.metadata (12 kB)
  Obtaining dependency information for fastapi from https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.4-py3-none-any.whl.metadata
  Downloading https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.4-py3-none-any.whl.metadata (12 kB)
  Obtaining dependency information for fastapi from https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.3-py3-none-any.whl.metadata
  Downloading https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.3-py3-none-any.whl.metadata (12 kB)
  Obtaining dependency information for fastapi from https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.2-py3-none-any.whl.metadata
  Downloading https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.2-py3-none-any.whl.metadata (12 kB)
  Obtaining dependency information for fastapi from https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.0-py3-none-any.whl.metadata
  Downloading https://archive1.piwheels.org/simple/fastapi/fastapi-0.1.0-py3-none-any.whl.metadata (431 bytes)
ERROR: Package 'rotator-library' requires a different Python: 3.11.2 not in '>=3.12'

Steps to Reproduce

g clone git@github.com:Mirrowel/LLM-API-Key-Proxy.git
cd LLM-API-Key-Proxy
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Expected Behavior

Normal installation

Actual Behavior

OMG, I already described the error above! How many times do I need to copy & paste the error?

Error Logs / Messages

Pre-submission Checklist

• I have searched existing issues to ensure this is not a duplicate

[Mirrobot-Agent]

@hernanmd Thanks for the report — and no need to paste the error again, the log you attached was plenty. 🙂 The installer is rejecting your Python 3.11.2 because the bundled rotator-library package declares requires-python >= 3.12. I'll dig into where that constraint comes from, whether it's intentional, and what the cleanest path to a working install on your setup is. Report back shortly.

[Mirrobot-Agent]

Initial Analysis Report

Summary: The install failure is expected behavior with your Python version: the bundled rotator_library package declares requires-python = ">=3.12", but the README's "From Source" instructions never mention that requirement — so the docs let you walk straight into a hard failure.

Issue Validation: Confirmed (the constraint is real and deliberate; the missing documentation is the actual bug).

Reproducibility Assessment: Reproducible — any environment running pip install -r requirements.txt on Python < 3.12 will hit exactly this error.

Root Cause Analysis:

• requirements.txt line 9 installs the bundled library in editable mode (-e src/rotator_library), so pip validates its metadata before doing anything else.
• src/rotator_library/pyproject.toml declares requires-python = ">=3.12". This was deliberately raised from >=3.10 in commit a990d92 ("chore(config): update project metadata and python requirement", 2026-01-24).
• The Docker path is consistent with this (Dockerfile uses python:3.12-slim), but the README "From Source" section (lines ~76–83) just says python3 -m venv venv with no version note. Your python3 is 3.11.2 → pip rejects the package.
• Side note on the scary-looking middle of your log: pip walking through fastapi 0.1.x is just resolver backtracking noise after the conflict — fastapi is not a separate problem here.

Suggested Labels: documentation — the code behaves as designed; the install docs omit a prerequisite. (Arguably bug from a user-experience standpoint; leaving that to the maintainers.)

Proposed Next Steps:

For you (immediate workarounds), pick whichever fits:

1. uv (easiest on ARM): pip install uv (or curl installer), then uv venv --python 3.12 && source .venv/bin/activate && pip install -r requirements.txt — uv downloads a standalone CPython 3.12, no system packages touched.
2. pyenv: pyenv install 3.12 && pyenv local 3.12, then recreate the venv.
3. Docker: the repo's supported docker compose up -d path already runs on Python 3.12.

One observation: your log shows piwheels and aarch64, which points to Raspberry Pi OS rather than stock Debian 13 — genuine Debian 13 ships Python 3.13, which would have installed cleanly. On Raspberry Pi OS (Bookworm-based, Python 3.11) the system interpreter can't satisfy the requirement, hence option 1 or 2.

For the maintainers:

1. 🟠 Major — Add the Python ≥ 3.12 requirement to the README "From Source" section (and the Deployment guide) so this failure mode is documented. This is the primary fix.
2. 🔵 Info — I searched the codebase for features that actually require 3.12 (PEP 695 type statements, itertools.batched, Path.walk, etc.) and found none — the newest syntax in use is structural pattern matching (3.10+). Relaxing the floor to >=3.10/>=3.11 would let stock Raspberry Pi OS / Debian 12 users install directly, but commit a990d92 looks like a deliberate policy choice, so that's a maintainer call rather than a defect.
3. 🔵 Info — Because rotator_library is a local editable dependency, the version error only surfaces after a long resolver backtracking session (the fastapi 0.1.x crawl in the log), which makes the real cause much harder to spot. A one-line prerequisite note in the docs fixes most of that pain.

Missing Information: None — your report was complete (and needed only one paste 🙂).

This analysis was generated by an AI assistant.

[Mirrowel]

Don't have much to add to what the bot said. Not exactly a bug - just need newer python version.
You can just edit the file to not require 3.12 - to 3.11 instead.
I'll note this for the docs.