ansible/awx

awxkit - requires deprecated pkg_resources

Closed

#16378 opened on Mar 30, 2026

View on GitHub
 (2 comments) (0 reactions) (0 assignees)Python (13,071 stars) (3,333 forks)batch import
communitydependencieshelp wantedtype:bug

Description

Please confirm the following

  • I agree to follow this project's code of conduct.
  • I have checked the current issues for duplicates.
  • I understand that AWX is open source software provided for free and that I might not receive a timely response.
  • I am NOT reporting a (potential) security vulnerability. (These should be emailed to security@ansible.com instead.)

Bug Summary

Trying to use awxkit with python 3.12. It installs but then fails on startup: Traceback (most recent call last): File "/home/gitlab-runner/.local/bin/awx", line 3, in <module> from awxkit.cli import run File "/home/gitlab-runner/.local/share/pipx/venvs/awxkit/lib/python3.12/site-packages/awxkit/cli/__init__.py", line 9, in <module> from .client import CLI File "/home/gitlab-runner/.local/share/pipx/venvs/awxkit/lib/python3.12/site-packages/awxkit/cli/client.py", line 5, in <module> import pkg_resources ModuleNotFoundError: No module named 'pkg_resources'

Looks like pkg_resources has been deprecated: https://setuptools.pypa.io/en/latest/deprecated/pkg_resources.html

Injecting a version of setuptools < v82.0.0 seems to work.

AWX version

24.6.1

Select the relevant components

  • UI
  • UI (tech preview)
  • API
  • Docs
  • Collection
  • CLI
  • Other

Installation method

kubernetes

Modifications

no

Ansible version

No response

Operating system

ubuntu24.04

Web browser

No response

Steps to reproduce

pip3 install awxkit awx

Expected results

awx is not crashing on start.

Actual results

awx cli is crashing. Traceback (most recent call last): File "/home/gitlab-runner/.local/bin/awx", line 3, in <module> from awxkit.cli import run File "/home/gitlab-runner/.local/share/pipx/venvs/awxkit/lib/python3.12/site-packages/awxkit/cli/__init__.py", line 9, in <module> from .client import CLI File "/home/gitlab-runner/.local/share/pipx/venvs/awxkit/lib/python3.12/site-packages/awxkit/cli/client.py", line 5, in <module> import pkg_resources ModuleNotFoundError: No module named 'pkg_resources'

Additional information

No response

Contributor guide