NVIDIA / NVIDIA/OpenShell

bug(cli): sandbox help references unpublished Python image

Open Beginner friendly
#2,888 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area:cli state:validated
Dominant language
Rust
Stars
8.7k
Forks
1.3k
Avg merge
2d 11h
Merged PRs (30d)
253

Description

User Story

As an OpenShell user, I want the CLI's sandbox examples to reference a published community image so that I can successfully follow the built-in help.

Problem Statement

openshell sandbox --help recommends openshell sandbox create --from python, but OpenShell Community does not publish a python sandbox. The CLI consequently treats python as a local directory and fails because it contains no Dockerfile.

Impact / Why This Matters

Users following the built-in example cannot create a sandbox and may misdiagnose the failure as a gateway or container-runtime problem. The current workaround is to discover a valid image name independently or provide the full community base image reference, which defeats the purpose of the built-in quickstart example.

Acceptance Criteria

  • The sandbox help example references a currently published OpenShell Community sandbox.
  • The example can resolve without requiring a local Dockerfile named after the example.
  • Relevant CLI help tests are updated or added if applicable.

Reproduction Steps

  1. Install OpenShell 0.0.111.
  2. Run openshell sandbox --help and observe the openshell sandbox create --from python example.
  3. Run openshell sandbox create --from python.
  4. Observe No Dockerfile found in directory: python.

Environment

  • OpenShell: 0.0.111
  • OS: macOS 26.5.2 on Apple Silicon
  • Runtime, deployment, or integration: Homebrew gateway with Docker through Colima

Logs

Error:   × No Dockerfile found in directory: python

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by running openshell sandbox --help and locate the CLI source that defines its sandbox examples. Verify the referenced image is currently published and that openshell sandbox create --from <image> resolves without looking for a local Dockerfile. Update or add the relevant CLI help test, if applicable, and confirm the example works.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
cli
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.