For maintainers
Let people try your project before they install it.
A Run on pyrovue badge at the top of your README turns a visitor into a user in about a minute. They click, sign in and get your project running in a box of their own, with a preview, a terminal and a tour of the code.
The badge
One line of Markdown.
[](https://pyrovue.com/github.com/OWNER/REPO?ref=badge)The button page writes it for your repository in Markdown, HTML and reStructuredText, and for a branch if you like.
What it does
Fewer "it won't build" issues.
- Visitors try it running
- No clone, no install, no version mismatch. They see your project work before they decide to install it.
- It costs you nothing
- Each visitor's box runs on their own plan, so a popular README doesn't send you a bill.
- The first setup is reused
- When a setup works, its steps are saved for that commit, and every later visitor gets them replayed in seconds instead of worked out again.
- Pull requests too
- A small workflow comments a run link on each pull request, so reviewers and contributors can see changes running. See pull request previews.
- You stay in control
- A
pyrovue.jsonat the root of your repo says exactly how to install and start it, and the badge only offers a box: nothing starts without a click.
Questions
Asked often.
Yes, a free one, so their boxes and hours are theirs. The link first shows your repository and what it will run, then asks them to sign in.
Yes, for public projects on gitlab.com, nested groups included. The pull request workflow is for GitHub.
Add a
pyrovue.json with the setup commands, start command and port. The support page has the reference and an example with a separate backend.Run the repo you bookmarked and never tried.
Hobby is free and needs no card. Paste a link and your first box is up in about a minute.