Skip to content

Commit 5917f3a

Browse files
committed
Update README.md
1 parent c378e5c commit 5917f3a

File tree

1 file changed

+19
-18
lines changed

1 file changed

+19
-18
lines changed

README.md

Lines changed: 19 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -6,27 +6,27 @@
66

77
Using Oracle JET, create a user-friendly prompt-led user interface (UI) to interact with Oracle's new Generative AI service. This toolkit will configure your Generative AI Service connection so you can begin your journey with AI, or migrate your existing (local or Cloud) LLMs to the Oracle AppDev ecosystem.
88

9-
Oracle JET(Preact) allows you to craft pixel-perfect UI's which are fast, lightweight, and engaging. Your code takes center stage with Oracle JET, while its powerful features enable you to create dynamic user experiences quickly and reliably.
9+
Oracle JET(Preact) allows you to craft pixel-perfect UIs which are fast, lightweight, and engaging. Your code takes centre stage with Oracle JET, while its powerful features enable you to create dynamic user experiences quickly and reliably.
1010

11-
Oracle's Generative AI service allows developers to unlock a better user experience for chat systems, question and answer solutions, and much more. This project provides a front end to that service so you can experiment and get a sense of the immense power of Oracle Generative AI. This is an excellent starting point on your AI journey, and experienced developers will be able to quickly port their LLMs to leverage this powerful service for enhanced customer support solutions.
11+
Oracle's Generative AI service allows developers to unlock a better user experience for chat systems, question-and-answer solutions, and much more. This project provides a front end to that service so you can experiment and get a sense of the immense power of Oracle Generative AI. This is an excellent starting point on your AI journey, and experienced developers will be able to quickly port their LLMs to leverage this powerful service for enhanced customer support solutions.
1212

1313
![alt text here](images/main.png)
1414

1515
## Getting Started
1616

1717
### 0. Set up
1818

19-
Follow links below to generate a config file and a key pair in your ~/.oci directory
19+
Follow the links below to generate a config file and a key pair in your ~/.oci directory
2020

2121
- [SDK config](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdkconfig.htm)
2222
- [API signing key](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm)
2323
- [CLI install](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm#configfile)
2424

25-
After completion, you should have following 2 things in your `~/.oci directory `
25+
After completion, you should have the following 2 things in your `~/.oci directory `
2626

2727
a. A config file(where key file point to private key:key_file=`~/.oci/oci_api_key.pem`)
2828
b. A key pair named `oci_api_key.pem` and `oci_api_key_public.pem`
29-
Now make sure you change the reference of key file in config file (where key file point to private key:key_file=/YOUR_DIR_TO_KEY_FILE/oci_api_key.pem)
29+
Now make sure you change the reference of the key file in the config file (where the key file points to private key:key_file=/YOUR_DIR_TO_KEY_FILE/oci_api_key.pem)
3030

3131
- Append OCI Generative-AI service compartment and endpoint URL
3232
`vim service/python/server.py`
@@ -49,7 +49,7 @@ generative_ai_inference_client = (
4949

5050
### 1. (Optional)Modify websocket ports
5151

52-
- In root of project directory run to edit ports
52+
- In the root of the project directory run to edit ports
5353
`vim app/web/components/content/index.tsx`
5454

5555
```Javascript
@@ -69,9 +69,9 @@ async def start_server():
6969
- Upload your oci_api_key_public.pem to console:
7070
[API signing key](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#three)
7171

72-
### 3. Make sure you have python installed on your machine
72+
### 3. Make sure you have Python installed on your machine
7373

74-
- In cli run following command to validate Python version
74+
- In cli run the following command to validate the Python version
7575
`python --version`
7676

7777
You should see similar output:
@@ -82,11 +82,11 @@ Python 3.8.3
8282

8383
### 4. Install all dependencies
8484

85-
We suggest you install dependencies in a virtual env to avoid conflicts on your system.
85+
We suggest you install dependencies in a virtual environment to avoid conflicts on your system.
8686

8787
- Navigate to the server root folder
8888
`cd service/python`
89-
- Create vitrual environment:
89+
- Create a virtual environment:
9090
`python3 -m venv venv`
9191
- Activate your virtual environment:
9292
`. venv/bin/activate`
@@ -95,7 +95,7 @@ We suggest you install dependencies in a virtual env to avoid conflicts on your
9595
- Install requirements:
9696
`pip3 install -r requirements.txt`
9797

98-
## 5. Start websocket server app
98+
## 5. Start the websocket server app
9999

100100
Once dependencies are installed and your service credentials are updated you can run server.py
101101

@@ -104,24 +104,24 @@ Once dependencies are installed and your service credentials are updated you can
104104
## 6. Start JET Client
105105

106106
- Open app directory:
107-
`cd ../../app ` or `cd app/` in root folder
107+
`cd ../../app ` or `cd app/` in the root folder
108108
- Install dependencies:
109109
`ojet restore`
110110
- Run local version:
111111
`ojet serve`
112112
- Or package for web deployment
113113
`ojet build web`
114114

115-
Ask you questions to generate AI response
115+
Ask your questions to generate an AI response
116116
![alt text here](images/QandA.png)
117117

118-
Note that app is capable of generating markdown
118+
Note that the app is capable of generating markdown
119119
![alt text here](images/Markdown.png)
120120

121121
## Appendix: Token-based Authentication
122122

123123
Check [Token-based Authentication for the CLI](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/clitoken.htm#Running_Scripts_on_a_Computer_without_a_Browser)
124-
if need to run testing with session token via BOAT. Here is the sample config to setup client with session token in the test scripts:
124+
if need to run testing with session token via BOAT. Here is the sample config to set the client with a session token in the test scripts:
125125

126126
```Python
127127
config = oci.config.from_file('~/.oci/config', profile_name="DEFAULT")
@@ -152,7 +152,7 @@ Additional Use Cases like summarization and embedding coming soon.
152152
To change output parameters edit server.py
153153

154154
```Python
155-
cohere_generate_text_request.max_tokens = 500 # choose number of tokens 1-4000
155+
cohere_generate_text_request.max_tokens = 500 # choose the number of tokens 1-4000
156156
cohere_generate_text_request.temperature = 0.75 # adjust temperature 0-1
157157
cohere_generate_text_request.top_p = 0.7 # adjust top_p 0-1
158158
cohere_generate_text_request.frequency_penalty = 1.0 # adjust frequency_penalty
@@ -164,7 +164,7 @@ To change output parameters edit server.py
164164
- [AI for Developer](developer.oracle.com/ai)
165165

166166
## Contributing
167-
This project is open source. Please submit your contributions by forking this repository and submitting a pull request! Oracle appreciates any contributions that are made by the open source community.
167+
This project is open source. Please submit your contributions by forking this repository and submitting a pull request! Oracle appreciates any contributions that are made by the open-source community.
168168

169169
## License
170170
Copyright (c) 2024 Oracle and/or its affiliates.
@@ -173,4 +173,5 @@ Licensed under the Universal Permissive License (UPL), Version 1.0.
173173

174174
See [LICENSE](LICENSE) for more details.
175175

176-
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.
176+
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.
177+

0 commit comments

Comments
 (0)