Merge branch 'main' into exacc-education-update

Author: MelanieBenham

ai/ai-ecosystem/README.md

@@ -0,0 +1,9 @@
+# Generative AI Ecosystem
+
+Reviewed: 02.07.2025
+
+# Team Publications
+
+## GitHub
+
+- [NVIDIA Omniverse Digital Twin](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/ai-ecosystem/nvidia-omniverse-digital-twin)

ai/ai-ecosystem/nvidia-omniverse-digital-twin/LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2025 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ai/ai-ecosystem/nvidia-omniverse-digital-twin/README.md

@@ -0,0 +1,111 @@
+# Digital Twin Example using NVIDIA Omniverse
+
+This solution demonstrates how to run a digital twin of an automobile in a wind
+tunnel to evaluate the aerodynamic effect of modifications to the features of
+the car.
+The digital twin runs on the NVIDIA Omniverse software platform and uses GPU
+nodes on Oracle Cloud Infrastructure (OCI) to visualize the airflow over the
+car as well as AI inference to quickly assess how changes to the car will
+affect the airflow.
+
+Reviewed: 02.07.2025
+
+# When to use this asset?
+
+This asset is ideal for developers, educators, or any professional looking for:
+
+- Demonstrate Oracle Cloud capabilities: This is a great demo asset to showcase
+  the abilities of OCI to run applications utilizing the NVIDIA Omniverse framework
+
+# How to use this asset?
+
+## Prerequisites
+
+To run this tutorial, you will need:
+
+* An OCI tenancy with limits set for GPU based instances, with a minimum of 2 GPUs available, either:
+  * NVIDIA A10 for a minimum demonstration
+  * NVIDIA L40S for optimal visualization performance
+* An access key to NVIDIA's NGC Catalog
+
+The software setup is describe in depth [in the NVIDIA Omniverse Blueprint](https://github.com/NVIDIA-Omniverse-blueprints/digital-twins-for-fluid-simulation).
+
+## Deploying the supporting GPU shape
+
+1. Navigate to the "Instances" in the Cloud Console, and create a new instance:
+   - Select "Canonical Ubuntu 24.04" as the image, and at the minimum "VM.GPU.A10.2" as the shape
+   - Select a public subnet to place the machine in
+     - Note the VCN and subnet used
+   - Upload or paste your public SSH key
+   - Increase the boot volume size to 150 Gb
+
+2. After the instance has been created, navigate to the VCN that the instance uses, and create a new security list under the tab "Security".  Use the following settings:
+   <center><img src="files/subnet.png" alt="Security list settings opening ports for Omniverse kit and web applications" style="max-width:90%; height:auto;" /></center>
+
+## Deploying the Digital Twin
+
+1. SSH into the deployed shape and first enable the NVIDIA container toolkit repository:
+   ```console
+   curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg \
+     && curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
+        sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
+        sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
+   ```
+
+2. Update the package cache and install the required software:
+   ```console
+   sudo apt update
+   sudo apt install -y build-essential git-lfs docker-compose-v2
+   sudo apt install -y nvidia-driver-570-server nvidia-container-toolkit
+   ```
+   
+3. Configure the container runtime, add the current user to the Docker group and reboot:
+   ```console
+   sudo nvidia-ctk runtime configure --runtime=docker
+   sudo usermod -aG docker ubuntu
+   sudo reboot
+   ```
+   
+4. Open the ZeroMQ ports required for the web app to communicate with the
+   inferencing backend:
+   ```console
+   sudo iptables -I INPUT -p tcp -m multiport --dports 5555:5560 -j ACCEPT
+   sudo iptables -I INPUT -p tcp -m multiport --sports 5555:5560 -j ACCEPT
+   ```
+   
+5. Log into the NVIDIA container registry using `$oauthtoken` as user and your
+   NGC token as password.  Then clone the digital twin example and build it:
+   ```console
+   docker login nvcr.io
+   git clone https://github.com/NVIDIA-Omniverse-blueprints/digital-twins-for-fluid-simulation.git
+   cd digital-twins-for-fluid-simulation
+   ./build-docker.sh
+   ```
+   
+6. Copy the [configuration script `setup.sh`](./files/setup.sh) to the node and
+   run it, then start the digital twin:
+   ```console
+   bash ./setup.sh
+   docker compose up
+   ```
+   
+7. You should now be able to navigate to your node's public IP, on port 5273 in
+   a browser and evaluate the digital twin:
+   <center><img src="files/twin_running.png" alt="A digital twin of a car in a wind tunnel, running in NVIDIA Omniverse" style="max-width:90%; height:auto;" /></center>
+
+
+# Acknowledgments
+
+- **Author** - Matthias Wolf (Generative AI Ecosystem Black Belt)
+
+# External links
+
+* [NVIDIA Omniverse Blueprint for Digital Twins for Fluid Simulation](https://github.com/NVIDIA-Omniverse-blueprints/digital-twins-for-fluid-simulation)
+
+# License
+
+Copyright (c) 2025 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

ai/ai-ecosystem/nvidia-omniverse-digital-twin/files/setup.sh

@@ -0,0 +1,45 @@
+PRIVATE_IP=$(ip route get 1 | sed 's/^.*src \([^ ]*\).*$/\1/;q')
+PUBLIC_IP=$(curl ipinfo.io/ip)
+
+sed -e "s/127.0.0.1/${PRIVATE_IP}/g" .env_template > .env
+
+cat <<EOF | git apply
+diff --git a/compose.yml b/compose.yml
+index b89118a..06bed98 100644
+--- a/compose.yml
++++ b/compose.yml
+@@ -7,7 +7,9 @@ services:
+       dockerfile: kit-app/Dockerfile
+       network: host
+     privileged: true
+-    network_mode: host 
++    networks:
++      outside:
++        ipv4_address: ${PUBLIC_IP}
+     ports:
+       - "1024:1024/udp"
+       - "49100:49100/tcp"
+@@ -52,8 +54,8 @@ services:
+       NGC_API_KEY: "\${NGC_API_KEY}"
+     network_mode: host
+     ipc: host
+-    ports: 
+-      - "8080:8080"
++    # ports:
++    #   - "8080:8080"
+   zmq:
+     image: "rtdt-zmq-service:latest"
+     restart: unless-stopped
+@@ -73,3 +75,11 @@ services:
+ volumes:
+   ov-cache:
+   ov-local-share:
++
++networks:
++  outside:
++    driver: bridge
++    ipam:
++      driver: default
++      config:
++        - subnet: ${PUBLIC_IP%.*}.0/24
+EOF

ai/ai-ecosystem/nvidia-omniverse-digital-twin/files/subnet.png

@@ -1,8 +1,8 @@
 **/__pycache__/
 venv/
-files/venv/
-**/config.py
+config.py
 .DS_Store
 data/
 *.log
 *.txt
+!requirements.txt

ai/ai-ecosystem/nvidia-omniverse-digital-twin/files/twin_running.png

@@ -28,8 +28,9 @@ See [LICENSE](./LICENSE) for more details.
 
 ---
 
+> ORACLE AND ITS AFFILIATES DO NOT PROVIDE ANY WARRANTY WHATSOEVER, EXPRESS OR IMPLIED, FOR ANY SOFTWARE, MATERIAL OR CONTENT OF ANY KIND CONTAINED OR PRODUCED WITHIN THIS REPOSITORY, AND IN PARTICULAR SPECIFICALLY DISCLAIM ANY AND ALL IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. FURTHERMORE, ORACLE AND ITS AFFILIATES DO NOT REPRESENT THAT ANY CUSTOMARY SECURITY REVIEW HAS BEEN PERFORMED WITH RESPECT TO ANY SOFTWARE, MATERIAL OR CONTENT CONTAINED OR PRODUCED WITHIN THIS REPOSITORY. IN ADDITION, AND WITHOUT LIMITING THE FOREGOING, THIRD PARTIES MAY HAVE POSTED SOFTWARE, MATERIAL OR CONTENT TO THIS REPOSITORY WITHOUT ANY REVIEW. USE AT YOUR OWN RISK.
 
 
 ## Disclaimer
 
-ORACLE AND ITS AFFILIATES DO NOT PROVIDE ANY WARRANTY WHATSOEVER, EXPRESS OR IMPLIED, FOR ANY SOFTWARE, MATERIAL OR CONTENT OF ANY KIND CONTAINED OR PRODUCED WITHIN THIS REPOSITORY, AND IN PARTICULAR SPECIFICALLY DISCLAIM ANY AND ALL IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.  FURTHERMORE, ORACLE AND ITS AFFILIATES DO NOT REPRESENT THAT ANY CUSTOMARY SECURITY REVIEW HAS BEEN PERFORMED WITH RESPECT TO ANY SOFTWARE, MATERIAL OR CONTENT CONTAINED OR PRODUCED WITHIN THIS REPOSITORY. IN ADDITION, AND WITHOUT LIMITING THE FOREGOING, THIRD PARTIES MAY HAVE POSTED SOFTWARE, MATERIAL OR CONTENT TO THIS REPOSITORY WITHOUT ANY REVIEW. USE AT YOUR OWN RISK.
+ORACLE AND ITS AFFILIATES DO NOT PROVIDE ANY WARRANTY WHATSOEVER, EXPRESS OR IMPLIED, FOR ANY SOFTWARE, MATERIAL OR CONTENT OF ANY KIND CONTAINED OR PRODUCED WITHIN THIS REPOSITORY, AND IN PARTICULAR SPECIFICALLY DISCLAIM ANY AND ALL IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. FURTHERMORE, ORACLE AND ITS AFFILIATES DO NOT REPRESENT THAT ANY CUSTOMARY SECURITY REVIEW HAS BEEN PERFORMED WITH RESPECT TO ANY SOFTWARE, MATERIAL OR CONTENT CONTAINED OR PRODUCED WITHIN THIS REPOSITORY. IN ADDITION, AND WITHOUT LIMITING THE FOREGOING, THIRD PARTIES MAY HAVE POSTED SOFTWARE, MATERIAL OR CONTENT TO THIS REPOSITORY WITHOUT ANY REVIEW. USE AT YOUR OWN RISK.

ai/generative-ai-service/hr-goal-alignment/.gitignore

@@ -1,4 +1,3 @@
-# Copyright (c) 2025 Oracle and/or its affiliates.
 import streamlit as st
 from urllib.parse import quote, unquote
 
@@ -100,7 +99,7 @@ def create_org_chart():
 """
 
 # Display the chart with HTML component
-st.components.v1.html(html_chart, height=520, scrolling=True) # type: ignore
+st.components.v1.html(html_chart, height=520, scrolling=True)
 
 # Show details section for selected employee
 # ------------------------------------------------------------
@@ -182,5 +181,5 @@ def chip_style(val):
                 else "background-color:#f8d7da;font-weight:bold"
             )
 
-        styled = goals_pretty.style.applymap(chip_style, subset=[LABEL_COL]) # type: ignore
+        styled = goals_pretty.style.applymap(chip_style, subset=[LABEL_COL])
         st.dataframe(styled, use_container_width=True, hide_index=True)

ai/generative-ai-service/hr-goal-alignment/README.md

@@ -51,6 +51,7 @@ The system integrates with Oracle Database and uses OCI's Generative AI models t
 ├── utils.py
 ├── requirements.txt
 └── README.md
+```
 
 ## Setup Instructions
 

ai/generative-ai-service/hr-goal-alignment/files/Org_Chart.py

@@ -1,4 +1,3 @@
-# Copyright (c) 2025 Oracle and/or its affiliates.
 import streamlit as st
 from pathlib import Path
 
@@ -30,4 +29,4 @@
 
 
 pg = st.navigation(pages)
-pg.run()
+pg.run()

ai/generative-ai-service/hr-goal-alignment/files/README.md

@@ -1,4 +1,3 @@
-# Copyright (c) 2025 Oracle and/or its affiliates.
 # config_template.py
 
 # === OCI Configuration ===

ai/generative-ai-service/hr-goal-alignment/files/app.py

@@ -1,4 +1,3 @@
-# Copyright (c) 2025 Oracle and/or its affiliates.
 from typing import List, Dict, Optional
 from langchain_community.vectorstores import OracleVS
 import os
@@ -13,7 +12,6 @@
 from langchain_text_splitters import RecursiveCharacterTextSplitter
 from langchain_community.embeddings import OCIGenAIEmbeddings
 from langchain_core.documents import Document
-from langchain_community.vectorstores.utils import DistanceStrategy
 
 # Use the project's config file
 import config
@@ -62,7 +60,7 @@ def _initialize_vector_store(self) -> OracleVS:
             client=self.db_conn, # Use the connection passed in __init__
             embedding_function=self.embeddings, # Use the embeddings initialized in __init__
             table_name=config.VECTOR_TABLE_NAME, # Use table name from project config
-            distance_strategy=DistanceStrategy.COSINE
+            distance_strategy="COSINE"
         )
 
     # LLM initialization removed.
@@ -169,3 +167,5 @@ def similarity_search(self, query: str, k: int = 5) -> List[Document]:
         except Exception as e:
             logger.error(f"Error during similarity search: {e}", exc_info=True)
             return []
+
+

ai/generative-ai-service/hr-goal-alignment/files/config_template.py

@@ -1,4 +1,3 @@
-# Copyright (c) 2025 Oracle and/or its affiliates.
 import logging
 import sys
 import oracledb