Slither Python API fails to resolve Chainlink imports despite remappings - "Source not found" error

[Ad-h0c]

I'm trying to analyze a Solidity contract using Slither's Python API, but I'm getting compilation errors when the contract imports Chainlink dependencies. The imports can't be resolved even though I have the dependencies installed and remappings configured.

Error:

SlitherError: Invalid compilation: 
Invalid solc compilation Error: Source "@chainlink/contracts-ccip/src/v0.8/shared/access/OwnerIsCreator.sol" not found: File not found. Searched the following locations: "".

My setup:

• Contract imports: import {OwnerIsCreator} from "@chainlink/contracts-ccip/src/v0.8/shared/access/OwnerIsCreator.sol";
• Dependencies installed: npm install @chainlink/contracts-ccip ✓

  @chainlink/=node_modules/@chainlink/
  @openzeppelin/=node_modules/@openzeppelin/
  

Python code:

from slither import Slither
from solcx import install_solc, set_solc_version, get_executable

# Set up Solidity version
version = "0.8.19"  # example
install_solc(version)
set_solc_version(version)
os.environ['SOLC_BINARY'] = str(get_executable(version))

# Change to project root
os.chdir(project_root)

# This fails:
slither = Slither(
    contract_path,
    solc=os.environ['SOLC_BINARY']
)

What I've tried:

1. Using solc_remaps parameter: slither = Slither(path, solc_remaps=["@chainlink/=node_modules/@chainlink/"])
2. Using solc_args with various formats: --remap, --include-path, --base-path
3. Verifying dependencies exist: node_modules/@chainlink/contracts-ccip/src/v0.8/shared/access/OwnerIsCreator.sol ✓
4. Testing with direct solc command (works fine)

Environment:

• Python: 3.13
• solc: 0.8.19
• OS: macOS

Any help would be greatly appreciated!