Merge pull request #1504 from oracle-devrel/aisolhub-jb

new modifications required to publish in AI Solution Hub

Author: al3xne

ai/ai-speech/podcast-generator/Podcast-md/README.md

@@ -60,6 +60,8 @@ Identify the compartment you're currently working within. Navigate to 'Identity'
 * Automatically a podcast script will be created and will generate the audio podcast using the Cindy and Bob voices
   ![alt text](generated.jpg)
 
+## Notes
+* It is important to note that, as of the time of writing this tutorial, the Speech-to-Text service is available exclusively in the Phoenix region.
 
 ## I hope you liked it.
 Author: Jesús Brasero

ai/ai-speech/podcast-generator/README.md

@@ -5,15 +5,70 @@ The application is designed to streamline podcast production through advanced AI
 This application is built using Oracle Visual Builder Cloud Service (VBCS), a powerful low-code platform that simplifies development and accelerates the creation of robust applications without extensive coding. With this low-code approach, even complex workflows are straightforward to set up, allowing developers to focus on leveraging AI's potential for high-quality audio synthesis.
 This AI-powered solution not only automates and optimizes the podcast creation process but also allows content creators to deliver professional audio content at scale efficiently.
 
-Reviewed: 22.11.2024
+Reviewed: 26.11.2024
 
-# When to use this asset?
- 
-See the README document in the /Podcast-md folder.
- 
-# How to use this asset?
+# **1. Prepare your user**
+   
+   In Oracle Cloud Infrastructure (OCI), API keys are used for secure authentication when accessing OCI resources through REST APIs. OCI API keys consist of two parts: a Public key and a Private key. You use the OCI console to generate the Private/Public key pair.
+   Generate API Keys using OCI Console
+    To Generate the API Keys using OCI Console:
+
+  - Login into your OCI Account.
+   ![alt text]![alt text](Podcast-md/ak1.png)
+  - Click on the Profile icon at the top-right corner and select your Profile hyperlink.
+   ![alt text](Podcast-md/ak2.png)
+  - Under Resources section at the bottom-left, select API Keys and then click Add API Key.
+   ![alt text](Podcast-md/ak3.png)
+  - The Add API Key dialog is displayed. Select Generate API Key Pair to create a new key pair.
+  ![alt text](Podcast-md/ak4.png)
+  - Click Download Private Key. A .pem file is saved to your local device. You do not need to download the public key and click Add button.
+  ![alt text](Podcast-md/ak5.png)
+  
+
+
+# **2.Pick you compartment**
+Identify the compartment you're currently working within. Navigate to 'Identity' -> 'Compartments'. Locate your compartment and make a note of its OCID (Oracle Cloud Identifier)
+
+# **3.Open Visual Builder**
+## Import Visual Builder project
+* Open Visual Builder and click on the "Import" button. Choose "Application from file".
+* Drop the zip project file
+* Provide a name and an ID, for example "Podcast_Generator". Click on Import button.
+ ![alt text](Podcast-md/import_project.jpg)
+  
+## Configure REST APIs authentication
+* Open the recently created project.
 
-See the README document in the /Podcast-md folder.
+* Click on Services button (left side) and click on "Backends"
+ ![alt text](Podcast-md/services.jpg)
+
+* Now, click on TTS, and Servers to edit server authentication.
+![alt text](Podcast-md/edit_tts.jpg)
+
+* Click the pencil to provide the OCI Crendentials
+ ![alt text](Podcast-md/edit_tts_2.jpg)
+
+* Provide the crendentials you got during the step 1.
+ ![alt text](Podcast-md/signature.jpg)
+
+* Repeat the same process with the GenAI backend.
+
+## Provide your compartmentId 
+* Provide compartmentId default value in the project variable named "comparmentid" that you got during the step 2.
+ ![alt text](Podcast-md/compartmentid.jpg)
+
+#  **4.Preview the application**
+* Now can provide a topic in the text area and click "generate" button. 
+ ![alt text](Podcast-md/preview.jpg)
+
+* Automatically a podcast script will be created and will generate the audio podcast using the Cindy and Bob voices
+  ![alt text](Podcast-md/generated.jpg)
+
+## Notes
+* It is important to note that, as of the time of writing this tutorial, the Speech-to-Text service is available exclusively in the Phoenix region.
+
+## I hope you liked it.
+Author: Jesús Brasero
 
 # License