Skip to content

docs: Clarify installation instructions for running examples#354

Open
natinew77-creator wants to merge 1 commit intogoogle-deepmind:masterfrom
natinew77-creator:fix/installation-docs-issue-297
Open

docs: Clarify installation instructions for running examples#354
natinew77-creator wants to merge 1 commit intogoogle-deepmind:masterfrom
natinew77-creator:fix/installation-docs-issue-297

Conversation

@natinew77-creator
Copy link

Summary

This PR addresses issue #297 by updating the README installation instructions to help users avoid import errors when running examples.

Problem

Users who install dm-acme via pip and try to run the examples encounter import errors like:

cannot import name 'sac' from 'acme.agents.jax'

This happens because the PyPI package was last updated in February 2022, while the GitHub repository has continued to evolve with new agents and features.

Solution

Updated the README.md to:

  1. Add a prominent warning that the PyPI package may be outdated
  2. Recommend installing from source as the primary method for running examples
  3. Reorganize installation steps to emphasize source installation first
  4. Add troubleshooting note for users who encounter import errors after pip install

Changes

  • README.md: Reorganized installation section with clearer guidance

Fixes #297This PR addresses issue #297 by updating the README to:

  1. Add a prominent warning that the PyPI package may be outdated
  2. Recommend installing from source as the primary method for running examples
  3. Reorganize installation steps to emphasize source installation
  4. Add troubleshooting note for import errors after pip install

The PyPI package (dm-acme) was last updated in February 2022, while the GitHub repository has continued to evolve with new agents and features. This mismatch causes import errors when users try to run the examples after installing via pip.

Fixes #297

This PR addresses issue google-deepmind#297 by updating the README to:

1. Add a prominent warning that the PyPI package may be outdated
2. Recommend installing from source as the primary method for running examples
3. Reorganize installation steps to emphasize source installation
4. Add troubleshooting note for import errors after pip install

The PyPI package (dm-acme) was last updated in February 2022, while the
GitHub repository has continued to evolve with new agents and features.
This mismatch causes import errors when users try to run the examples
after installing via pip.

Fixes google-deepmind#297
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.

examples seem to be broken - examples/baselines/rl_continuous

1 participant