simulo 0.30.0__tar.gz → 0.31.0__tar.gz

{simulo-0.30.0/src/simulo.egg-info → simulo-0.31.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo
-Version: 0.30.0
+Version: 0.31.0
 Summary: Python SDK and CLI for cloud-native robotics simulation, reinforcement learning, and robot policy training on managed GPUs.
 Author-email: Simulo Team <team@simulo.ai>
 License: BSD-3-Clause
@@ -92,14 +92,17 @@ Simulo requires Python 3.11 or newer. One installation provides both the
 simulo create mybot
 simulo login
 cd mybot
+simulo run preview.py --frozen --strict-assets
 simulo run train.py --frozen --strict-assets
+simulo run play.py --policy policy_<job>:best --frozen --strict-assets
 ```
 
 `simulo create` writes a complete starter application to your machine without
-requiring a login or network connection. It creates `task.py`, `train.py`, and
-`.simuloignore`; the default application trains a PPO policy on a validated cartpole
-asset. `simulo run` packages the source, resolves
-and pins its assets, submits the job, and follows its cloud logs.
+requiring a login or network connection. It creates `task.py`, `preview.py`,
+`train.py`, `play.py`, and `.simuloignore`. Run `preview.py` first as a separate
+job to check the validated cartpole asset in its task, run `train.py` to train a
+PPO policy, then pass that policy to `play.py`. `simulo run` packages the source,
+resolves and pins its assets, submits the job, and follows its cloud logs.
 
 ## Explore robotics samples
 

{simulo-0.30.0 → simulo-0.31.0}/PYPI.md

@@ -36,14 +36,17 @@ Simulo requires Python 3.11 or newer. One installation provides both the
 simulo create mybot
 simulo login
 cd mybot
+simulo run preview.py --frozen --strict-assets
 simulo run train.py --frozen --strict-assets
+simulo run play.py --policy policy_<job>:best --frozen --strict-assets
 ```
 
 `simulo create` writes a complete starter application to your machine without
-requiring a login or network connection. It creates `task.py`, `train.py`, and
-`.simuloignore`; the default application trains a PPO policy on a validated cartpole
-asset. `simulo run` packages the source, resolves
-and pins its assets, submits the job, and follows its cloud logs.
+requiring a login or network connection. It creates `task.py`, `preview.py`,
+`train.py`, `play.py`, and `.simuloignore`. Run `preview.py` first as a separate
+job to check the validated cartpole asset in its task, run `train.py` to train a
+PPO policy, then pass that policy to `play.py`. `simulo run` packages the source,
+resolves and pins its assets, submits the job, and follows its cloud logs.
 
 ## Explore robotics samples
 

{simulo-0.30.0 → simulo-0.31.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simulo"
-version = "0.30.0"
+version = "0.31.0"
 description = "Python SDK and CLI for cloud-native robotics simulation, reinforcement learning, and robot policy training on managed GPUs."
 readme = "PYPI.md"
 requires-python = ">=3.11"

{simulo-0.30.0 → simulo-0.31.0}/src/simulo/_client/cli.py

@@ -27,7 +27,8 @@ default stays out of submitted ``args`` and preserves the no-flags
 ``package_id``.
 
 ``simulo create <name> [--dir PATH] [--force]`` scaffolds a training app folder
-(``<name>/task.py``, ``<name>/train.py``, and ``<name>/.simuloignore``) from a
+(``<name>/task.py``, ``<name>/preview.py``, ``<name>/train.py``,
+``<name>/play.py``, and ``<name>/.simuloignore``) from a
 starter template bundled INSIDE this wheel as package data (loaded via
 ``importlib.resources``, not a path relative to this repo). This is the ONLY
 delivery vehicle for a starter app: the repo's ``demos/`` directory sits outside
@@ -5074,11 +5075,9 @@ def _validate_app_name(name: str) -> None:
         )
 
 
-#: The first ``simulo run`` a fresh scaffold user should type, printed as the
-#: "Next steps" line by ``_cmd_create``.
-#: Pinned end-to-end by ``test_create_next_step_command_actually_runs``, which
-#: executes each printed command verbatim against a fresh scaffold.
-_TEMPLATE_NEXT_RUN_COMMAND = "simulo run train.py"
+#: The ``simulo run`` commands a fresh scaffold user should type before policy
+#: playback, in order, printed as the "Next steps" lines by ``_cmd_create``.
+_TEMPLATE_NEXT_RUN_COMMANDS = ("simulo run preview.py", "simulo run train.py")
 
 
 def _cmd_create(args: argparse.Namespace) -> int:
@@ -5091,7 +5090,7 @@ def _cmd_create(args: argparse.Namespace) -> int:
     ``{{APP_NAME}}`` token. No network call, no auth.
 
     A pre-existing, non-empty target folder is refused unless ``--force`` (which
-    prints the two filenames it overwrote — a destructive action stays visible in
+    prints the filenames it overwrote — a destructive action stays visible in
     the output); an existing EMPTY folder (or no folder at all) needs no
     ``--force``. Every filesystem failure writing the scaffold — including a bad
     ``--dir`` that names an existing FILE rather than a directory (``mkdir``
@@ -5153,7 +5152,8 @@ def _cmd_create(args: argparse.Namespace) -> int:
     print(f"{verb} app in {target_dir}/ ({written}).")
     print("Next steps:")
     print(f"  cd {target_dir}")
-    print(f"  {_TEMPLATE_NEXT_RUN_COMMAND}")
+    for command in _TEMPLATE_NEXT_RUN_COMMANDS:
+        print(f"  {command}")
     print("  simulo run play.py --policy policy_<job>:best  # after training")
     return 0
 
@@ -8145,10 +8145,13 @@ def _build_parser() -> argparse.ArgumentParser:
 
     create = sub.add_parser(
         "create",
-        description="Scaffold task.py, train.py, play.py, and .simuloignore without network access or authentication.",
+        description=(
+            "Scaffold task.py, preview.py, train.py, play.py, and .simuloignore "
+            "without network access or authentication."
+        ),
         help=(
             "Scaffold a new Simulo app folder from a starter template shipped inside this wheel "
-            "(writes task.py, train.py, play.py, and .simuloignore; no network, no auth)."
+            "(writes task.py, preview.py, train.py, play.py, and .simuloignore; no network, no auth)."
         ),
     )
     create.add_argument(

{simulo-0.30.0 → simulo-0.31.0}/src/simulo/_client/templates/__init__.py

@@ -2,8 +2,9 @@
 
 The repo's ``demos/`` tree lives outside the packaged ``src/`` layout and never
 reaches a real ``pip install simulo`` user — this package is the fix. The
-``training/`` directory holds the three files created by ``simulo create``:
-``task.py.tmpl``, ``train.py.tmpl``, and ``simuloignore.tmpl``.
+``training/`` directory holds the five files created by ``simulo create``:
+``task.py.tmpl``, ``preview.py.tmpl``, ``train.py.tmpl``, ``play.py.tmpl``,
+and ``simuloignore.tmpl``.
 
 The ``.tmpl`` suffix is load-bearing, not cosmetic: these files contain
 ``import torch`` and other content that is not a valid, importable module on

simulo-0.31.0/src/simulo/_client/templates/training/preview.py.tmpl

@@ -0,0 +1,10 @@
+"""Check the robot inside the task before training; this preview makes no policy."""
+
+import simulo
+
+from task import StarterTask, app
+
+
+@app.job(type="preview", system=simulo.SystemType.TIER_1, timeout=15 * 60)
+def preview(num_envs: int = 16, checks: str = "all"):
+    return simulo.preview(StarterTask(), num_envs=num_envs, checks=checks, video=True)

{simulo-0.30.0 → simulo-0.31.0/src/simulo.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simulo
-Version: 0.30.0
+Version: 0.31.0
 Summary: Python SDK and CLI for cloud-native robotics simulation, reinforcement learning, and robot policy training on managed GPUs.
 Author-email: Simulo Team <team@simulo.ai>
 License: BSD-3-Clause
@@ -92,14 +92,17 @@ Simulo requires Python 3.11 or newer. One installation provides both the
 simulo create mybot
 simulo login
 cd mybot
+simulo run preview.py --frozen --strict-assets
 simulo run train.py --frozen --strict-assets
+simulo run play.py --policy policy_<job>:best --frozen --strict-assets
 ```
 
 `simulo create` writes a complete starter application to your machine without
-requiring a login or network connection. It creates `task.py`, `train.py`, and
-`.simuloignore`; the default application trains a PPO policy on a validated cartpole
-asset. `simulo run` packages the source, resolves
-and pins its assets, submits the job, and follows its cloud logs.
+requiring a login or network connection. It creates `task.py`, `preview.py`,
+`train.py`, `play.py`, and `.simuloignore`. Run `preview.py` first as a separate
+job to check the validated cartpole asset in its task, run `train.py` to train a
+PPO policy, then pass that policy to `play.py`. `simulo run` packages the source,
+resolves and pins its assets, submits the job, and follows its cloud logs.
 
 ## Explore robotics samples
 

{simulo-0.30.0 → simulo-0.31.0}/src/simulo.egg-info/SOURCES.txt

@@ -53,6 +53,7 @@ src/simulo/_client/view_session_api.py
 src/simulo/_client/volume.py
 src/simulo/_client/templates/__init__.py
 src/simulo/_client/templates/training/play.py.tmpl
+src/simulo/_client/templates/training/preview.py.tmpl
 src/simulo/_client/templates/training/simuloignore.tmpl
 src/simulo/_client/templates/training/task.py.tmpl
 src/simulo/_client/templates/training/train.py.tmpl