Skip to main content

Running GitHub repositories on Replit

GitHub repositories can be run automatically on Replit. Head to to import a repository. You can unlock private repositories after authenticating with GitHub and purchasing the Replit Core membership.

From the modal above, you can select the repo, language, and owner of the Repl. We will automatically detect the language if your GitHub repository already has a .replit file!

Configuring a Cloned Repo

When you clone a repository without a .replit file, we automatically show the visual .replit editor:

This will automatically create the .replit file and make it possible to customize how the repl will run.

You can use the shell to run any command and then set the "Run" button once you've decided what it should do.

Clicking "done" will finalize the Repl's configuration and close the visual editor.

Adding a .replit file to a repository makes cloning fast with no configuration necessary. The configuration file can always be changed at any time. For more information on how to configure your Repl, see the documentation on Configuring your Repl.

Adding a "Run on Replit" Badge

After configuring a run command for your Repl, you can add a badge to your repository README that will allow anyone to run your project automatically!

Generate a badge

Was this helpful?