Skip to content

Commit

Permalink
cloud world hol 204 and 211 (#328)
Browse files Browse the repository at this point in the history
* new folder created

* genai_smart_apps addition

* manifest file changed

* changes in the files

* changes for small modifications

* changed the apps live lab

* issues resolved

* removed images

* added images

* solve title issue

* changes recommended by live labs team

* changes in gen ai apps as suggested by the live lab team

* manifest file changes
  • Loading branch information
anshoracle authored Aug 16, 2024
1 parent 71e0e92 commit 37d891c
Show file tree
Hide file tree
Showing 100 changed files with 2,747 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Introduction

In today's digital age, companies are leveraging advanced technologies like Generative AI to enhance their business operations and customer interactions. Whether it's automating customer service, generating insights from data, or creating engaging content, Generative AI is transforming the way businesses operate.

**Workshop Description:** In this session, we will explore how Oracle Cloud Infrastructure Generative AI can be embedded into your applications to solve real business challenges. From document summarization to natural language conversations grounded in documents, website content creation, and transcriptions from videos, OCI Generative AI offers a versatile set of tools to improve productivity and efficiency. Discover how to leverage OCI generative ai and open frameworks to build smarter, more efficient applications.

## About this Workshop

In this workshop, you will learn how to utilize OCI Generative AI to enhance your applications and solve practical business problems.

**Estimated Workshop Time:** 45 minutes

### Objectives

In this workshop, you will learn how to:

* Integrate OCI Generative AI into your applications.
* Utilize document summarization capabilities to condense large volumes of information.
* Implement natural language processing for creating conversational interfaces.
* Generate and manage website content using AI.
* Convert youtube video content into text through transcription.
* Leverage open frameworks and OCI services to boost application efficiency.

## Learn More

* [OCI Generative AI overview](https://www.oracle.com/artificial-intelligence/generative-ai/)
* [OCI Generative AI service documentation](https://docs.oracle.com/en-us/iaas/Content/generative-ai/home.htm)

## Acknowledgements

* **Author** - Anshuman Panda, Principal Generative AI Specialist, Alexandru Negrea , AI and App Integration Specialist Leader

**Last Updated By/Date** - Anshuman Panda, Principal Generative AI Specialist, Aug 2024
Binary file added genai-smart-apps/2-setup/images/addApiKey.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added genai-smart-apps/2-setup/images/configFile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added genai-smart-apps/2-setup/images/configPreview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added genai-smart-apps/2-setup/images/downloadKey.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added genai-smart-apps/2-setup/images/userProfile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
154 changes: 154 additions & 0 deletions genai-smart-apps/2-setup/setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,154 @@
# Setup OCI-cli

## Introduction

In this lab, we will go over the steps to install and configure OCI-cli, a command-line interface tool for managing Oracle Cloud resources. By the end of this guide, you should be able to access and manage your Oracle Cloud tenant from your command line.

Estimated Time: 15 minutes

## Objectives

By the end of this lab, you will have:

- Installed OCI-cli on your local machine
- Created an API key for your user
- Configured the OCI-cli with your API credentials
- Tested the CLI connection to your Oracle Cloud tenant

## Prerequisites

- An Oracle Cloud account
- Administrative access to the tenant

## Task 1: Install OCI-cli

The installation process for OCI-cli varies depending on your operating system. Below are the instructions for macOS and Linux:

### macOS

Open your terminal and run the following command:

```
<copy>
brew install oci-cli
</copy>
```

### Linux

Open your terminal and run the bash command with the script from the OCI-cli GitHub repository:

```
<copy>
bash -c "$(curl -L <https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh>)"
</copy>
```

For other operating systems or more detailed installation instructions, refer to the official documentation: [OCI CLI Quickstart](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm).

## Task 2: Create an API Key

To authenticate with OCI-cli, you need to create an API key for your user. Follow these steps:

1. Open the OCI console and click on your profile icon in the top-right corner.

2. Click on your user ID to open the user profile page.

![Open User Profile Page](./images/userProfile.png)

3. In the user profile, navigate to "User Settings" and select "API Keys".

4. Click on the "Add API Key" button.

![Add API key](./images/addApiKey.png)

5. A popup will appear. Download both the private and public key, and then click "Add".

![Download Key](./images/downloadKey.png)

6. A window will display the API key details. Copy the contents of the text box and click "Close".

![Config File](./images/configFile.png)

## Task 3: Configure OCI-cli

Now, we will set up the configuration file for OCI-cli:

1. Create a hidden directory (if it doesn't exist):

```
<copy>
mkdir ~/.oci
<\copy>
```

2. Create a config file inside the directory:

```
<copy>
touch ~/.oci/config
</copy>
```

3. Move the downloaded SSH keys to the `.oci` directory and rename them:

```
<copy>
mv ssh-key-2022-08-16.key ~/.oci/ssh-key.key
mv ssh-key-2020-08-16.key.pub ~/.oci/ssh-key.key.pub
</copy>
```

4. Open the config file and paste the content you copied from the API key details:

```
<copy>
vi ~/.oci/config
</copy>
```

5. Modify the last field of the config file using the absolute path of the private key.

Your config file should look similar to the image below:

![Config File Preview](./images/configPreview.png)

## Task 4: Test the Connection

To verify that OCI-cli is set up correctly, run the following command to list the regions of your Oracle Cloud tenant:

```
<copy>
oci iam region list
</copy>
```

If the command executes successfully and displays a list of regions, your OCI-cli is configured correctly.

## Download files

download the codes from [here](https://objectstorage.eu-frankfurt-1.oraclecloud.com/n/frpj5kvxryk1/b/ocw/o/OraclecloudWorld.zip) and unzip it.

Run the below command to install all the dependencies
```
<copy>
pip install -r requirements.txt
<\copy>
```
Once the dependencies are loaded run the below command to launch the app
```
<copy>
streamlit run ociChat.py
<\copy>
```
## Learn More

- [OCI CLI Installation](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm)
- [Managing API Keys](<https://docs.oracle.com/en-us/iaas/Content/Identity/Concepts/managingcredentials.htm#To4>)


## Acknowledgements

* **Author** - Anshuman Panda, Principal Generative AI Specialist, Alexandru Negrea , AI and App Integration Specialist Leader

**Last Updated By/Date** - Anshuman Panda, Principal Generative AI Specialist, Aug 2024
Loading

0 comments on commit 37d891c

Please sign in to comment.