Skip to content

Conversation

@burtenshaw
Copy link
Collaborator

@burtenshaw burtenshaw commented Nov 25, 2025

This PR solves this issue. In short, that the package is not straightforward or conventional to install or import.

DX changes

The PR has a significant amount of new lines, made mostly out of grepping and moving. The fundamental change is this:

User will install like this:

# install everything
pip install openenv
pip install git+https://github.com/meta-pytorch/OpenEnv.git

# install a subset of dependencies
pip install openenv[core]
pip install openenv[cli]

User can use the core library in their envs like so:

from openenv.core.client_types import StepResult
from openenv.core.http_env_client import HTTPEnvClient
from coding_env.models import CodeAction, CodeObservation, CodeState

And install in the env tomls with openenv[core], openenv, or git+https://github.com/meta-pytorch/OpenEnv.git, without a subdirectory reference.

Implementation

The Changes to implement this are:

  • Collapsed the repo into a single distributable openenv package: CLI + runtime live under src/openenv/. Following Python conventions and simplifying toml definition.
  • openenv_core is now a shim.
  • and extras ([core], [cli], [all]) express optional deps in `pyproject.toml.
  • Moved sample environments out of src/ into top-level envs/
  • updated the CLI template to use openenv.core
  • updated docs to import from openenv.core and depend on openenv[core],
  • Updated README, guides, scripts, and tests to the new layout

@meta-cla meta-cla bot added the CLA Signed This label is managed by the Meta Open Source bot. label Nov 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants