Skip to main content

Managing Projects

Projects enable you to develop and deploy endpoints entirely on RunPod's infrastructure.

Create a project

A RunPod project is a folder with everything you need to run a development session on a Pod.

  1. To create a new project, run the following command.
runpod project create
  1. Select a starter project. Starter projects include preliminary settings for different kinds of project environments, such as LLM or image diffusion development.
  2. Check the base image for included dependencies.
  3. (Optional) If you need dependencies that are not included or added by your starter project, add them to the generated requirements.txt file.
  4. Save your changes.

You've customized your project, and now you're ready to run a development session.

Run a development session

A development session is the active connection between your local environment and the project environment on your Pod. During a development session, local changes to your project propagate to the project environment in real time.

  1. To start a development session, run the following command.
runpodctl project dev
  1. When you're done developing, press ctrl + c to end the session. Your Pod will terminate automatically when the session ends.

You can resume developing at any time by running runpodctl project dev again.

Now that you've developed your project, you can deploy an endpoint directly to RunPod or build a Dockerfile to create a portable image.

Deploy a project

When you deploy a project, RunPod creates a serverless endpoint with access to saved project data on your network volume.

To deploy a project, run the following command.

runpodctl project deploy

Your project is now deployed to a Serverless Endpoint. You can interact with this Endpoint like you would any other Serverless Endpoint. For more information, see Endpoints.

Build a project

You have the option to build your project instead of deploying it as an endpoint. When you build a project, RunPod emits a Dockerfile.

To build a project, run the following command.

runpodctl project build

You can use the generated Dockerfile to build an image, then deploy the image to any API server.