Skip to content

Document which libraries are actually patched, archive the rest - #14

Merged
Lauqz merged 1 commit into
mainfrom
docs/clarify-modified-libs
Jul 26, 2026
Merged

Document which libraries are actually patched, archive the rest#14
Lauqz merged 1 commit into
mainfrom
docs/clarify-modified-libs

Conversation

@Lauqz

@Lauqz Lauqz commented Jul 26, 2026

Copy link
Copy Markdown
Owner

Answers the open question in the README: "Unfortunately, I can't remember which packages I modified. I advice you to install all of them to avoid bugs."

Every vendored package was diffed against the exact version pinned in environment.yml, with line endings normalised.

Actually patched (3 of 6)

package files what
supersuit 3.8.0 5 Dict observation support in frame_stack and black_death, plus 3 project-local workarounds
stable_baselines3 2.0.0 3 VecEnv 5-tuple step_wait() and (obs, info) reset()
msgpackrpc 0.4.1 1 RPC timeout 10s to 100s, so long AirSim calls do not die

Never modified (moved to archive/unmodified_libs/)

package result
pettingzoo 1.23.1 byte-identical to upstream, 0 files differ
msgpack 0.5.6 byte-identical to upstream
gymnasium 0.28.1 one file differs by two unused imports and two trailing #!!! comments; parsed AST is identical, so it is a no-op

Install those three from PyPI instead.

Upstream

The two general SuperSuit fixes are submitted:

Once merged, modified_libs/supersuit can be dropped entirely.

Also documented

The environment passes PettingZoo's parallel_api_test on PettingZoo 1.26.1, and the train.py wrapper chain runs on SuperSuit 3.11 with those two patches, on NumPy 2.x and Gymnasium 1.3. Verified with a mocked AirSim client, so it covers the API surface rather than a full simulator run.

Diff shape

877 pure renames (R100), 1 modified README, 2 new docs. No library source was changed by this PR.

Depends on #13 for the two source fixes.

The README said "I can't remember which packages I modified, install all of
them". Every vendored package has now been diffed against the exact version
pinned in environment.yml.

Only three are patched:

  supersuit         5 files: Dict observation support in frame_stack and
                    black_death, plus three project-local workarounds
  stable_baselines3 3 files: VecEnv 5-tuple step / (obs, info) reset
  msgpackrpc        1 file:  RPC timeout 10s -> 100s for AirSim

Three were never modified and moved to archive/unmodified_libs:

  pettingzoo 1.23.1   byte-identical to upstream
  msgpack 0.5.6       byte-identical to upstream
  gymnasium 0.28.1    one file differs by two unused imports and two
                      trailing comments; the parsed AST is identical

modified_libs/PATCHES.md records what each patch does. The two SuperSuit
fixes are submitted upstream as SuperSuit#268 and SuperSuit#269; once merged,
supersuit can be dropped from this folder.

Also documents that the environment passes pettingzoo's parallel_api_test on
PettingZoo 1.26.1 and that the train.py wrapper chain runs on SuperSuit 3.11
with those two patches.
@Lauqz
Lauqz merged commit e8999ca into main Jul 26, 2026
Lauqz added a commit that referenced this pull request Jul 26, 2026
Document which libraries are actually patched, archive the rest
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants