Environment Triage

uv sync

pip install

Pattern

DO

# What uv ACTUALLY uses
uv run python --version

# What's pinned (this controls uv)
cat .python-version

# Confirm package is installed
uv pip show <package>

# Confirm import works in uv context
uv run python -c "import <package>; print(<package>.__version__)"

Common Fix

echo "3.13" > .python-version
rm -rf .venv && uv venv && uv sync --all-extras

DON'T

• Trust

  python3 --version

  when using uv
• Assume install succeeded without verifying import
• Debug further before checking interpreter version

Source Sessions

• 2243c067: symbolica-agentica skipped due to

  python_version >= 3.12

  marker, but uv was using 3.11
• 4784f390: agentica import failures traced to wrong interpreter