Hosted or on-device deployment
SDKs optimized for maximum performance
Extensive documentation
In this guide, we are going to show how to deploy a
PaliGemma
model to
AWS 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
PaliGemma
model to
AWS 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
PaliGemma
model to
AWS EC2
using the Roboflow Inference Server. This SDK works with
PaliGemma
models trained on both Roboflow and in custom training processes outside of Roboflow.
To deploy a
PaliGemma
model to
AWS 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, you will need to upload your trained PaliGemma model to Roboflow. This will allow you to download your model weights directly into your Inference deployment, whether you use the SDK or the HTTP API with Docker.
Next, 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. You will need to run Inference on a GPU device to run CogVLM. 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
AWS 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
AWS EC2
.
pip install inference supervision
Now you have the Roboflow Inference Server running, you can use your model on
AWS 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
With the Python SDK installed, you can run inference on your model in a few lines of Python code.
The following code will run inference on the model hosted on Roboflow and return a JSON object with predictions:
from PIL import Image
import inference
from inference.models.paligemma.paligemma import PaliGemma
import os
from google.colab import userdata
pg = PaliGemma(api_key=os.environ.get('ROBOFLOW_API_KEY'))
image = Image.open("/content/dog.webp") # Change to your image
prompt = "How many dogs are in this image?"
result = pg.predict(image,prompt)
display(image,)
print(result[0])
Substitute the model API key with the values associated with your Roboflow account and project, then run the script.
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
PaliGemma
models to other devices.
The following resources are useful reference material for working with your model using Roboflow and the Roboflow Inference Server.