Building Cloud Run application utilizing Streamlit Framework that demonstrates Receipt OCR using Gemini API

Run the Application locally (on Cloud Shell)

NOTE: Before you move forward, ensure that you have followed the instructions in SETUP.md. Additionally, ensure that you have cloned this repository and you are currently in the gemini-ocr-streamlit folder. This should be your active working directory for the rest of the commands.

To run the Streamlit Application locally (on Cloud Shell), we need to perform the following steps:

1. Setup the Python virtual environment and install the dependencies:

   In Cloud Shell, execute the following commands:

   python3 -m venv gemini-streamlit
   source gemini-streamlit/bin/activate
   pip install -r requirements.txt

2. Your application requires access to two environment variables:

   • GCP_PROJECT : This the Google Cloud project ID.
   • GCP_REGION : This is the region in which you are deploying your Cloud Run app. For example, us-central1.

   These variables are needed since the Vertex AI initialization needs the Google Cloud project ID and the region. The specific code line from the app.py function is shown here: vertexai.init(project=PROJECT_ID, location=LOCATION)

   In Cloud Shell, execute the following commands:

   export GCP_PROJECT='<Your Google Cloud Project ID>'  # Change this
   export GCP_REGION='us-central1'             # If you change this, make sure the region is supported.

3. To run the application locally, execute the following command:

   In Cloud Shell, execute the following command:

   streamlit run app.py \
     --browser.serverAddress=localhost \
     --server.enableCORS=false \
     --server.enableXsrfProtection=false \
     --server.port 8080

Build and Deploy the Application to Cloud Run

NOTE: Before you move forward, ensure that you have followed the instructions in SETUP.md. Additionally, ensure that you have cloned this repository and you are currently in the gemini-streamlit-cloudrun folder. This should be your active working directory for the rest of the commands.

To deploy the Streamlit Application in Cloud Run, we need to perform the following steps:

1. Your Cloud Run app requires access to two environment variables:

   • GCP_PROJECT : This the Google Cloud project ID.
   • GCP_REGION : This is the region in which you are deploying your Cloud Run app. For e.g. us-central1.

   These variables are needed since the Vertex AI initialization needs the Google Cloud project ID and the region. The specific code line from the app.py function is shown here: vertexai.init(project=PROJECT_ID, location=LOCATION)

   In Cloud Shell, execute the following commands:

   export GCP_PROJECT='<Your Google Cloud Project ID>'  # Change this
   export GCP_REGION='us-central1'             # If you change this, make sure the region is supported.

2. Build and deploy the service to Cloud Run:

   In Cloud Shell, execute the following command to name the Cloud Run service:

   export SERVICE_NAME='gemini-streamlit-app' # This is the name of our Application and Cloud Run service. Change it if you'd like.

   In Cloud Shell, execute the following command:

   gcloud run deploy "$SERVICE_NAME" \
     --port=8080 \
     --source=. \
     --allow-unauthenticated \
     --region=$GCP_REGION \
     --project=$GCP_PROJECT \
     --set-env-vars=GCP_PROJECT=$GCP_PROJECT,GCP_REGION=$GCP_REGION \
     --cpu 4 \
     --cpu-boost \
     --memory 4Gi