Skip to content

Conversation

@morty649
Copy link

This PR adds a minimal headless example demonstrating how to interact with the
commons_harvest__open substrate programmatically without a graphical display.

Motivation:

  • Existing tutorial examples rely on pygame and require a GUI
  • New users running Melting Pot in headless environments (servers, CI, or
    GitHub Codespaces) lack a simple reference for stepping environments
  • TensorFlow/XLA initialization warnings and sparse rewards can be confusing
    for first-time users

What this adds:

  • A lightweight, headless example using substrate.build
  • Random-action stepping to demonstrate observations and rewards
  • Inline documentation explaining expected warnings and sparse rewards

Notes:

  • Rewards are intentionally sparse and may remain zero for many steps
  • TensorFlow/XLA initialization warnings may appear in headless environments
    and are harmless

No core logic is modified.

@google-cla
Copy link

google-cla bot commented Jan 13, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

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.

1 participant