[PDF Skill] macOS: dependency install guidance should default to venv, not system `python -m pip`

Resolved 💬 3 comments Opened Feb 13, 2026 by kingtistel Closed Mar 29, 2026
💡 Likely answer: A maintainer (etraut-openai, contributor) responded on this thread — see the highlighted reply below.

I was suggested by @etraut-openai to open an issue using the feedback mechanism

Summary

On macOS, Codex sometimes suggests commands like python -m pip install ... that target system/global Python.
This often fails (permissions / externally-managed environment) and is not a reliable default.
The guidance should default to creating and using a virtual environment first.

Environment

  • OS: macOS (reproducible across setups)
  • Tooling: Codex CLI / agent workflow
  • Typical failing pattern: python -m pip install ... without an active venv

Steps to Reproduce

  1. Ask Codex to install Python dependencies (example: reportlab, pdfplumber, pypdf).
  2. Codex suggests or runs python -m pip install ... directly.
  3. Install attempts to write to system package directories.
  4. Command fails due to permission/external-management constraints.

Actual Behavior

Codex proposes system-level pip installs as a fallback path.

Expected Behavior

Codex should prefer:

  1. python3 -m venv <path>
  2. source <path>/bin/activate
  3. python -m pip install -U pip
  4. python -m pip install <packages>

Optional: if uv is used, still require an active venv for package installation.

Why this matters

This is a common macOS failure mode and not environment-specific.
Defaulting to venv-based installs would prevent recurring setup failures and reduce user friction.

Proposed Fix

Update built-in install guidance (skills/prompts/docs) so Python dependency instructions always use isolated environments first, and avoid system Python installs by default.

View original on GitHub ↗

3 Comments

kingtistel · 6 months ago

Forgot to mention

mention your thread ID 019c5218-e873-7792-83c6-41a88e2e96a6 in an existing issue
ZedOud · 6 months ago

That or using uv, which while not installed by default, is considered the better alternative for managing virtual environments and python installations.

etraut-openai contributor · 5 months ago

This feature request hasn't received enough upvotes, so I'm closing it.