Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ Requirements:

## Adding a Skill

Skills live inside their sandbox's `skills/` directory (e.g., `sandboxes/openclaw/skills/my-skill/`). Each skill should include:
Skills live inside their sandbox's `skills/` directory (e.g., `sandboxes/my-sandbox/skills/my-skill/`). Each skill should include:
- A `SKILL.md` describing what it does and when to use it
- Any supporting files the skill needs
- A README with usage examples
Expand Down
23 changes: 6 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,26 +7,26 @@

[OpenShell](https://github.com/NVIDIA/OpenShell) is the runtime environment for autonomous agents -- the infrastructure where they live, work, and verify. It provides a programmable factory where agents can generate synthetic data to fix edge cases and safely iterate through thousands of failures in isolated sandboxes. The core engine includes the sandbox runtime, policy engine, gateway (with k3s harness), privacy router, and CLI.

This repo is the community ecosystem around OpenShell -- a hub for contributed skills, sandbox images, launchables, and integrations that extend its capabilities. For the core engine, docs, and published artifacts (PyPI, containers, binaries), see the [OpenShell](https://github.com/NVIDIA/OpenShell) repo.
This repo is the community ecosystem around OpenShell -- a hub for contributed skills, sandbox images, and integrations that extend its capabilities. For the core engine, docs, and published artifacts (PyPI, containers, binaries), see the [OpenShell](https://github.com/NVIDIA/OpenShell) repo.

> Alpha software — single-player mode. OpenShell is proof-of-life: one developer, one environment, one gateway. We are building toward multi-tenant enterprise deployments, but the starting point is getting your own environment up and running. Expect rough edges. Bring your agent.

## What's Here

| Directory | Description |
| ------------ | --------------------------------------------------------------------------------- |
| `brev/` | [Brev](https://brev.dev) launchable for one-click cloud deployment of OpenShell |
| `sandboxes/` | Pre-built sandbox images for domain-specific workloads (each with its own skills) |

### Sandboxes

| Sandbox | Description |
| ----------------------- | ------------------------------------------------------------ |
| `sandboxes/base/` | Foundational image with system tools, users, and dev environment |
| `sandboxes/droid/` | Android automation and mobile testing workflows |
| `sandboxes/gemini/` | Gemini CLI workflows |
| `sandboxes/nvidia-gpu/` | GPU-enabled VM sandbox image with NVIDIA userspace tooling |
| `sandboxes/ollama/` | Ollama for local and cloud LLMs with Claude Code, Codex, OpenCode pre-installed |
| `sandboxes/sdg/` | Synthetic data generation workflows |
| `sandboxes/openclaw/` | OpenClaw -- open agent manipulation and control |
| `sandboxes/nvidia-gpu/` | GPU-enabled VM sandbox image with NVIDIA userspace tooling |

## Getting Started

Expand All @@ -36,24 +36,13 @@ This repo is the community ecosystem around OpenShell -- a hub for contributed s
- Docker or a compatible container runtime
- NVIDIA GPU with appropriate drivers (for GPU-accelerated images)

### Quick Start with Brev

Skip the setup and launch OpenShell Community on a fully configured Brev instance, whether you want to use Brev as a remote OpenShell gateway with or without GPU accelerators, or as an all-in-one playground for sandboxes, inference, and UI workflows.

| Instance | Best For | Deploy |
| -------- | -------- | ------ |
| CPU-only | Remote OpenShell gateway deployments, external inference endpoints, remote APIs, and lighter-weight sandbox workflows | <a href="https://brev.nvidia.com/"><img src="https://brev-assets.s3.us-west-1.amazonaws.com/nv-lb-dark.svg" alt="Deploy on Brev" height="40"/></a> |
| NVIDIA H100 | All-in-one OpenShell playgrounds, locally hosted LLM endpoints, GPU-heavy sandboxes, and higher-throughput agent workloads | <a href="https://brev.nvidia.com/"><img src="https://brev-assets.s3.us-west-1.amazonaws.com/nv-lb-dark.svg" alt="Deploy on Brev" height="40"/></a> |

After the Brev instance is ready, access the Welcome UI to inject provider keys and access your Openclaw sandbox.

### Using Sandboxes

```bash
openshell sandbox create --from openclaw
openshell sandbox create --from ollama
```

The `--from` flag accepts any sandbox defined under `sandboxes/` (e.g., `openclaw`, `ollama`, `sdg`), a local path, or a container image reference.
The `--from` flag accepts any sandbox defined under `sandboxes/` (e.g., `ollama`, `sdg`), a local path, or a container image reference.

### Ollama Sandbox

Expand Down
8 changes: 0 additions & 8 deletions THIRD-PARTY-NOTICES
Original file line number Diff line number Diff line change
Expand Up @@ -95,14 +95,6 @@ Package: vim-tiny
License: Vim
URL: https://packages.ubuntu.com/noble/vim-tiny

================================================================================
NPM Packages
================================================================================

Package: openclaw
License: Apache-2.0
URL: https://www.npmjs.com/package/openclaw

================================================================================
GitHub Actions
================================================================================
Expand Down
2 changes: 0 additions & 2 deletions brev/.gitignore

This file was deleted.

Loading
Loading