From f25a7abfe4236be064d5d931f335d0cca15e181a Mon Sep 17 00:00:00 2001
From: Matteo Rosati <rosati.matteo@gmail.com>
Date: Wed, 18 Feb 2026 18:15:28 +0100
Subject: [PATCH] add readme

---
 README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..70d4769
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# AKERN Assistant
+
+1. Have `gcloud` CLI configured (https://docs.cloud.google.com/sdk/docs/install-sdk?hl=it).
+2. Setup the Google Cloud project:
+
+**Login**
+
+```sh
+gcloud auth login
+```
+
+**Set the correct Google project**
+
+```sh
+gcloud config set core/project akqa-ita-ai-poc1
+```
+
+## Build the image
+
+Setup Docker first:
+
+```sh
+gcloud auth configure-docker \
+    europe-west3-docker.pkg.dev
+```
+
+This allows Docker to use gcloud credentials to authenticate in the registry. Then to push the image:
+
+```sh
+docker buildx build \
+    --platform linux/amd64 \
+    -t europe-west3-docker.pkg.dev/akqa-ita-ai-poc1/akern-repository/akern_assistant:latest \
+    --push \
+    .
+```
+
+## Deployment
+
+```sh
+gcloud run deploy akern-assistant \
+      --image europe-west3-docker.pkg.dev/akqa-ita-ai-poc1/akern-repository/akern_assistant:latest \
+      --platform managed \
+      --region europe-west3 \
+      --port 8080 \
+      --allow-unauthenticated \
+      --set-secrets "GOOGLE_APPLICATION_CREDENTIALS_JSON=google-credentials:latest,AUTH_USER=auth-user:latest,PASSWORD=auth-password:latest"
+```