Hosted or on-device deployment
SDKs optimized for maximum performance
Extensive documentation
In this guide, we are going to show how to deploy a
Segment Anything Model (SAM)
model to
EC2
using Roboflow Inference. Inference is a high-performance inference server with which you can run a range of vision models, from YOLOv8 to CLIP to CogVLM.
To deploy a
Segment Anything Model (SAM)
model to
EC2
, we will:
1. Set up our computing environment
2. Download the Roboflow Inference Server
3. Try out our model on an example image
Let's get started!
In this guide, we are going to show how to deploy a
Segment Anything Model (SAM)
model to
EC2
using the Roboflow Inference Server. This SDK works with
Segment Anything Model (SAM)
models trained on both Roboflow and in custom training processes outside of Roboflow.
To deploy a
Segment Anything Model (SAM)
model to
EC2
, we will:
1. Train a model on (or upload a model to) Roboflow
2. Download the Roboflow Inference Server
3. Install the Python SDK to run inference on images
4. Try out the model on an example image
Let's get started!
If you want to upload your own model weights, first create a Roboflow account and create a new project. When you have created a new project, upload your project data, then generate a new dataset version. With that version ready, you can upload your model weights to Roboflow.
Download the Roboflow Python SDK:
pip install roboflow
Then, use the following script to upload your model weights:
from roboflow import Roboflow
home = "/path/to/project/folder"
rf = Roboflow(api_key=os.environ["ROBOFLOW_API_KEY"])
project = rf.workspace().project("PROJECT_ID")
project.version(PROJECT_VERSION).deploy(model_type="yolov5", model_path=f"/{home}/yolov5/runs/train/")
You will need your project name, version, API key, and model weights. The following documentation shows how to retrieve your API key and project information:
- Retrieve your Roboflow project name and version
- Retrieve your API key
Change the path in the script above to the path where your model weights are stored.
When you have configured the script above, run the code to upload your weights to Roboflow.
Now you are ready to start deploying your model.
First, we need to create an AWS EC2 instance. EC2 is Amazon’s compute product that you can use to deploy virtual machines. Search for “EC2” in the search bar and navigate to EC2.
On the EC2 homepage, click the “Launch instance” button:
This button will take you to a page where you can configure the machine to create.
We recommend choosing the Amazon Linux operating system, which has been optimized for use in AWS. If you plan to use Inference on a GPU device, we recommend choosing a machine image optimized for deep learning, such as the Deep Learning Base GPU AMI image. This image will come with some tooling out of the box that will minimize GPU setup. If you want to deploy on a CPU device, the standard Amazon Linux operating system is recommended.
Once you have configured the virtual machine, you can deploy the system.
Next, sign in to your server with SSH. Read the AWS EC2 SSH instructions to learn more.
The Roboflow Inference Server allows you to deploy computer vision models to a range of devices, including
EC2
.
The Inference Server relies on Docker to run. If you don't already have Docker installed on the device(s) on which you want to run inference, install it by following the official Docker installation instructions.
Once you have Docker installed, run the following command to download the Roboflow Inference Server on your
EC2
.
Now you have the Roboflow Inference Server running, you can use your model on
EC2
.
The Roboflow Inference Server provides a HTTP API with a range of methods you can use to query your model and various popular models (i.e. SAM, CLIP). You can read more about all of the API methods available on the Roboflow Inference server in the Inference Server documentation.
The Roboflow Python SDK provides abstract convenience methods for interacting with the HTTP API. In this guide, we will use the Python SDK to run inference on a model. You can also query the HTTP API itself.
To install the Python SDK, run the following command:
pip install roboflow
The Segment Anything API, available at localhost:9001, allows you to retrieve image embeddings and segmentation masks for an image.
To retrieve masks, you should make a request to localhost:9001/sam/embed_image with:
1. An image from which to retrieve masks, and;
2. A prompt point. This point represents the object that you want to segment. The prompt point should have an ID and the x, y coordinates of the prompt.
To make a request to the API, you will need your Roboflow API key. Learn how to retrieve your Roboflow API key.
Below is an example showing how to make a request to the API. Read the documentation for more information about the Inference Segment Anything API.
import requests
infer_payload = {
"image": {
"type": "base64",
"value": "..."
},
"point_coords": [[380, 350]],
"point_labels": [1],
"image_id": "example_image_id",
}
res = requests.post(
f"{base_url}/sam/embed_image?api_key={api_key}",
json=infer_payload,
)
masks = request.json()['masks']
We take security seriously and have implemented comprehensive measures to keep your sensitive data safe
Below, you can find our guides on how to deploy
Segment Anything Model (SAM)
models to other devices.
The following resources are useful reference material for working with your model using Roboflow and the Roboflow Inference Server.