____ ____ ______ _ __ ______ __ __ ___ ______
/ __ \ / __ \ / ____// | / / / ____// / / // | /_ __/
/ / / // /_/ // __/ / |/ / / / / /_/ // /| | / /
/ /_/ // ____// /___ / /| / / /___ / __ // ___ | / /
\____//_/ /_____//_/ |_/ \____//_/ /_//_/ |_|/_/
pip install openchat
model='name'
when you create OpenChat
.Just import and create a object. That's all.
>>> from openchat import OpenChat
>>> OpenChat(model="blender.medium", device="cpu")
Set param device='cuda'
If you want to use GPU acceleration.
>>> from openchat import OpenChat
>>> OpenChat(model="blender.medium", device="cuda")
Set param device='cuda:n'
If you want to use a specific GPU.
>>> from openchat import OpenChat
>>> OpenChat(model="blender.medium", device="cuda:2") # <--- use 3rd GPU
>>> OpenChat(model="blender.medium", device="cuda:0") # <--- use 1st GPU
Set **kwargs
if you want to change decoding options.
["greedy", "beam", "top_k", "nucleus"]
,Decoding options must be keyword argument
not positional argument
.
>>> from openchat import OpenChat
>>> OpenChat(
... model="blender.medium",
... device="cpu",
... method="top_k",
... top_k=20,
... no_repeat_ngram_size=3,
... length_penalty=0.6,
... )
For safety.offensive
model, parameter method
must be one of ["both", "string-match", "bert"]
>>> from openchat import OpenChat
>>> OpenChat(
... model="safety.offensive",
... device="cpu"
... method="both" # ---> both, string-match, bert
... )
<br><br>
## Special Tasks
### 1. GPT-Neo
![](https://user-images.githubusercontent.com/38183241/113967262-972a8180-986b-11eb-9f02-68c9c093baf6.png)
- The GPT-Neo model was released in the EleutherAI/gpt-neo repository.
- It is a GPT2 like causal language model trained on the Pile dataset.
- Openchat supports the above Prompt based dialogues via GPT-Neo.
- Below models provides custom prompt setting. (`*` means all models)
- `gptneo.*`
<br><br>
### 2. ConvAI2
![](https://user-images.githubusercontent.com/38183241/112734380-bdf1d980-8f88-11eb-8ad7-18cf4d8d9ac6.png)
- ConvAI2 is one of the most famous conversational AI challenges about a persona.
- Openchat provides custom persona setting like above image.
- Below models provides custom perona setting. (`*` means all models)
- `blender.*`
- `dodecathlon.convai2`
- `unlikelihood.convai2.*`
<br><br>
### 3. Wizard of Wikipedia
![](https://user-images.githubusercontent.com/38183241/112734377-bb8f7f80-8f88-11eb-8c25-8c30691e29b8.png)
- Wizard of wikipedia is one of most famous knowledge grounded dialogue dataset.
- Openchat provides custom topic setting like above image.
- Below models provides custom topic setting. (`*` means all models)
- `wizard_of_wikipedia.end2end_generator`
- `dodecathlon.wizard_of_wikipedia`
- `unlikelihood.wizard_of_wikipedia.*`
<br><br>
### 4. Safety Agents
![](https://user-images.githubusercontent.com/38183241/112735485-b41fa480-8f8f-11eb-9ac2-2c51a5294551.png)
![](https://user-images.githubusercontent.com/38183241/112735488-b71a9500-8f8f-11eb-94ce-55461c02966e.png)
- Openchat provides a dialog safety model to help you design conversation model.
- Below models provides dialog safety features.
- `safety.offensive`: offensive words classification
- `safety.sensitive`: sensitive topic classification
<br><br>
## License
Copyright 2021 Hyunwoong Ko.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.