simulacat validates compatibility across the following dependency ranges. The "recommended" column is the default target for CI and local development.
| Dependency | Minimum supported | Recommended | Supported range |
|---|---|---|---|
| Python | 3.12 | 3.13 | >=3.12,<3.14 |
| github3.py | 3.2.0 | 4.0.1 | >=3.2.0,<5.0.0 |
| Node.js | 20.x | 22.x | 20.x-22.x |
| @simulacrum/github-api-simulator | 0.6.2 | 0.6.3 | >=0.6.2,<0.7.0 |
The compatibility workflow (.github/workflows/compatibility-matrix.yml) runs
reference suites across Python 3.12 and 3.13 with github3.py major tracks 3.x
and 4.x.
Known incompatibilities and workarounds
- Dependency:
github3.pyAffected versions:>=5.0.0,<6.0.0
ERROR: Could not find a version that satisfies the requirement github3.py>=5.0.0,<6.0.0
Workaround: use github3.py>=3.2.0,<5.0.0.
- Dependency: Python
Affected versions:
<3.12
ERROR: Package 'simulacat' requires a different Python
Workaround: use Python 3.12 or 3.13.