PlatformIO Library Manager "not found" in CI

PlatformIO's Library Manager tried to resolve an entry from lib_deps and found no matching library. The name, the owner/name form, or the version constraint does not exist in the registry.

What this error means

A pio run step fails while installing dependencies with "Library Manager: ... not found" or "Could not find the package with '<lib>' requirements".

Library Manager: Installing bblanchon/ArduinoJson @ ^99.0
Error: Could not find the package with 'bblanchon/ArduinoJson @ ^99.0' requirements for your system 'linux_x86_64'

Common causes

The library name or owner is wrong

Registry libraries resolve by owner/name or a registered name. A typo, or the bare name when the registry needs the owner form, finds nothing.

The version constraint excludes every release

A @ ^<version> or exact pin that no published release satisfies leaves the resolver with no candidate.

How to fix it

Use the exact registry spec in lib_deps

1. Find the library with pio pkg search <name> and copy its owner/name.
2. Set a version constraint that a published release satisfies.
3. Re-run so the Library Manager resolves it.

[env:esp32dev]
lib_deps =
  bblanchon/ArduinoJson@^7.0.4

Point at a git source for unpublished libraries

If the library is not in the registry, reference its repository directly so PlatformIO clones it.

lib_deps =
  https://github.com/owner/lib.git#v1.2.3

How to prevent it

• Pin owner/name@version so resolution is deterministic.
• Cache ~/.platformio so installed libraries persist across runs.
• Confirm git sources are reachable from the CI network.

Related guides