Install & Compatibility
Where this runs
tested against v7.0.10.99.0.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
build_error
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 4.4s · import 0.000s · 104MB
109MB installed
● package 109MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CLI invoke
✓ python -m epicscorelibs.cli --help
✗ import epicscorelibs
epicscorelibs is a bundled library; direct import is not intended for user code. Use its CLI or rely on it being automatically loaded by pyepics/caproto.
Load EPICS libraries
✓ import epicscorelibs.path # on import, sets PATH, LD_LIBRARY_PATH, etc.
✗ import epicscorelibs
epicscorelibs.path is the main entry point to make the bundled shared libraries discoverable. Importing epicscorelibs alone does nothing.
After installing epicscorelibs and pyepics, import epicscorelibs.path to set up library paths, then use pyepics normally.
import epicscorelibs.path
import epics
import ca
# Example: connect to an EPICS PV
pv = epics.PV('example:PV')
print(pv.get())
Errors
Common errors & fixes
ImportError: libca.so: cannot open shared object file: No such file or directory
epicscorelibs.path was not imported, so LD_LIBRARY_PATH is not set to include the bundled libraries.
fixAdd 'import epicscorelibs.path' before importing pyepics or caproto.
AttributeError: module 'epicscorelibs' has no attribute 'path'
Outdated version where the path module did not exist, or the installed package is corrupted.
fixUpgrade epicscorelibs: pip install --upgrade epicscorelibs
Upgrade
Version history
7.0.10.99.0.1latest on PyPI · released Feb 11, 2026
Audit
Dependencies
No dependency data recorded yet.