docs(readme): lead with the sandbox category and add package keywords - #840
Merged
Conversation
Agents choosing a sandbox rely heavily on web/registry retrieval, and the Python SDK's README, PyPI description, and repo metadata never named the category. Lead the README with what Runloop does, list the concrete advantages, and put install + a working quickstart on the first screen. Add PyPI keywords (previously empty) and point the docs links at docs.runloop.ai. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Co-authored-by: Reflex <reflex@runloop.ai>
|
✅ Reflex agent status: Completed
This PR was created by Reflex. This comment updates in place as agents work. |
dines-rl
approved these changes
Sep 4, 2026
Open
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Coding agents pick sandbox providers mostly through web and package-registry retrieval, not training priors. Today this repo gives that retrieval almost nothing to work with: the README opened with generated-client boilerplate, the PyPI description was "The official Python library for the runloop API",
keywordswas empty, and the docs links pointed at the marketing site and the typedoc page rather than docs.runloop.ai.What changed
README.md
pip install→ a working quickstart that creates a devbox, writes a file, and runs it.api.md,examples/, andllms.txt. Stainless/httpx boilerplate moved below the quickstart.pyproject.toml
descriptionnames the category.keywordsadded (was empty): sandbox, devbox, ai-agents, code-execution, code-interpreter, agent-runtime, microvm, llm.Homepage→ runloop.ai,Documentation→ docs.runloop.ai, typedoc site kept as "API Reference".Repo topics and the GitHub description/homepage were updated separately through the API — those aren't files.
Notes
devbox.file.write(...)/devbox.cmd.exec(...)API, checked againstsrc/runloop_api_client/sdk/devbox.py.runloopai/api-client-ts.🤖 Generated with Claude Code