From 5f671267730e2d73b951f7d97d437ce8e47873a2 Mon Sep 17 00:00:00 2001 From: Christophe Besson Date: Sun, 9 Aug 2026 21:43:31 +0200 Subject: fix: document pip SSL_CERT_FILE workaround for Python 3.14 on Ubuntu/Fedora pip + Python 3.14 fails with FileNotFoundError in certifi.where() on fresh venvs (truststore bug). Fix: SSL_CERT_FILE pointing to system CA bundle. Documented in CLAUDE.md (Python environment section) and QUICKSTART.md. Co-Authored-By: Claude Sonnet 4.6 (1M context) --- CLAUDE.md | 22 ++++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) (limited to 'CLAUDE.md') diff --git a/CLAUDE.md b/CLAUDE.md index 306cad3..fc28305 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -29,21 +29,23 @@ Jamais de processus orphelins ni de ports ouverts après un test. ## Python environment - **Minimum Python:** 3.12 -- **Package manager:** uv (`uv sync` at root installs all workspace packages in editable mode) - **Build backend:** hatchling (per package `pyproject.toml`) ```bash -# Install dev environment -uv sync - -# Run hub (dev mode) -uv run meshbay-hub +# Créer le venv et installer les packages +python3 -m venv .venv && source .venv/bin/activate +pip install -e packages/meshbay-common -e packages/meshbay-hub -e packages/meshbay-node +pip install httpx blake3 uvicorn pytest pytest-asyncio +``` -# Run node (dev mode) -uv run meshbay-node +> **Bug pip + Python 3.14** sur Ubuntu et Fedora : `FileNotFoundError` dans certifi. +> Passer `SSL_CERT_FILE` avant le premier `pip install` : +> - Ubuntu : `SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt pip install ...` +> - Fedora : `SSL_CERT_FILE=/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem pip install ...` -# Run tests -uv run pytest +```bash +# Lancer les tests +.venv/bin/pytest ``` ## Code conventions -- cgit v1.2.3