Skip to content

Commit 5a7d0ab

Browse files
committedDec 3, 2023
docs: update readme and plugin description
1 parent 46b88a4 commit 5a7d0ab

9 files changed

+85
-57
lines changed
 

‎DESCRIPTION.md

+12-11
Original file line numberDiff line numberDiff line change
@@ -7,30 +7,31 @@ Access state-of-the-art LLMs like GPT-4, Code LLama and more, all for free.
77

88
## Quick Start Guide
99

10-
1. **Download the Plugin**: Get started by downloading the plugin from the [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/21056-codegpt?preview=true).
10+
1. **Download the Plugin**
1111

12-
2. **Choose Your Preferred Service**:
12+
2. **Choose Your Preferred Service**
1313

1414
a) **OpenAI** - Requires authentication via OpenAI API key.
1515

1616
b) **Azure** - Requires authentication via Active Directory or API key.
1717

18-
c) **You.com** - A free, web-connected service with an optional upgrade to You⚡Pro for enhanced features..
18+
c) **You.com** - A free, web-connected service with an optional upgrade to You⚡Pro for enhanced features.
1919

20-
d) **LLaMA C/C++ Port** - Run Code Llama, WizardCoder, and other state-of-the-art models locally for free.
20+
d) **LLaMA C/C++ Port** - Run Code Llama, WizardCoder, Deepseek Coder, and other state-of-the-art models locally for free.
2121

22-
3. **Start Using the Features**: You're all set! Start exploring the features of our plugin.
22+
3. **Start Using the Features**
2323

2424
### OpenAI
2525

2626
After successful installation, configure your API key. Navigate to the plugin's settings via **File | Settings/Preferences | Tools | CodeGPT**. Paste your OpenAI API key into the field and click `Apply/OK`.
2727

28-
### Azure
28+
### Azure OpenAI
2929

3030
For Azure OpenAI services, you'll need to input three additional fields:
31-
* `Resource name`: The name of your Azure OpenAI Cognitive Services.
32-
* `Deployment ID`: The name of your Deployment.
33-
* `API version`: The most recent non-preview version.
31+
32+
- **Resource name**: The name of your Azure OpenAI Cognitive Services.
33+
- **Deployment ID**: The name of your Deployment.
34+
- **API version**: The most recent non-preview version.
3435

3536
Also, input one of the two provided API keys.
3637

@@ -58,15 +59,15 @@ The main goal of `llama.cpp` is to run the LLaMA model using 4-bit integer quant
5859

5960
3. **Apply Settings**: With the server running, you can now apply the settings to start using the features. Click on the `Apply/OK` button to save your settings and start using the application.
6061

61-
<img alt="animated" style="max-width: 100%; width: 600px;" src="https://github.com/carlrobertoh/CodeGPT/raw/master/docs/assets/llama_settings.png" />
62+
<img alt="animated" style="max-width: 100%; width: 600px;" src="https://github.com/carlrobertoh/CodeGPT/raw/master/docs/assets/llama-settings.png" />
6263

6364
> **Note**: If you're already running a server and wish to configure the plugin against that, then simply select the port and click `Apply/OK`.
6465
6566
## Features
6667

6768
The plugin provides several key features, such as:
6869

69-
### Ask Anything
70+
### Chat with AI
7071

7172
Ask anything you'd like.
7273

‎README.md

+73-46
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
</a>
88
<h1 style="margin: 0;" align="center">CodeGPT</h1>
99
<p>
10-
A JetBrains extension that allows you to use ChatGPT inside your favourite IDE
10+
A JetBrains extension providing access to state-of-the-art LLMs, such as GPT-4, Code Llama, and others, all for free
1111
</p>
1212
</div>
1313

@@ -21,6 +21,7 @@
2121
<summary>Table of Contents</summary>
2222
<ol>
2323
<li><a href="#about-the-project">About The Project</a></li>
24+
<li><a href="#quick-start-guide">Quick Start Guide</a></li>
2425
<li>
2526
<a href="#getting-started">Getting Started</a>
2627
<ul>
@@ -37,17 +38,60 @@
3738

3839
## About The Project
3940

40-
This is an extension for JetBrains IDEs that integrates ChatGPT into your coding environment.
41-
By leveraging the power of GPT-3, this makes it an invaluable tool for developers looking to streamline their workflow and gain a deeper understanding of the code they're working on.
41+
This is an extension for JetBrains IDEs that integrates AI into your coding environment.
42+
By leveraging the power of Large Language Models (LLMs), this makes it an invaluable tool for developers looking to streamline their workflow and gain a deeper understanding of the code they're working on.
43+
44+
## Features
45+
46+
The plugin provides several key features, such as:
47+
48+
### Chat with AI
49+
50+
<p align="center">
51+
<img src="docs/assets/chat-with-ai.png" alt="animated" />
52+
</p>
53+
54+
### Generate Git Commit Messages
55+
56+
<p align="center">
57+
<img src="docs/assets/generate-commit-message.png" />
58+
</p>
59+
60+
### Method name suggestions
61+
62+
<p align="center">
63+
<img src="docs/assets/method-name-suggestions.png" />
64+
</p>
65+
66+
### Multiple providers
67+
68+
<p align="center">
69+
<img src="docs/assets/model-selection.png" />
70+
</p>
71+
72+
### Other features
73+
74+
- **Conversation History** - View recent conversation history and restore previous sessions, making it easy to pick up where you left off
75+
- **Concurrent conversations** - Chat with AI in multiple tabs simultaneously
76+
- **Seamless conversations** - Chat with AI regardless of the maximum token limitations
77+
- **Predefined Actions** - Create your own editor actions or override the existing ones, saving time rewriting the same prompt repeatedly
4278

4379
## Getting Started
4480

45-
To get started, follow these simple steps:
81+
1. **Download the Plugin**
82+
83+
2. **Choose Your Preferred Service**:
84+
85+
a) **OpenAI** - Requires authentication via OpenAI API key.
86+
87+
b) **Azure** - Requires authentication via Active Directory or API key.
88+
89+
c) **You.com** - A free, web-connected service with an optional upgrade to You⚡Pro for enhanced features.
4690

47-
### Prerequisites
91+
d) **LLaMA C/C++ Port** - Recommended to have a decent computer to handle the computational requirements of running inference.
92+
> **Note**: Currently supported only on Linux and MacOS.
4893
49-
In order to use the extension, you need to have a JetBrains IDE installed and the API key configured.
50-
You can find the API key in your [User settings][api-key-url].
94+
3. **Start Using the Features**
5195

5296
### Installation
5397

@@ -57,64 +101,47 @@ On the `Marketplace` tab simply search for `codegpt` and select the `CodeGPT` su
57101

58102
![marketplace][marketplace-img]
59103

60-
### API Key Configuration
104+
### OpenAI
61105

62-
After the plugin has been successfully installed, the API key needs to be configured.
106+
After successful installation, configure your API key. Navigate to the plugin's settings via **File | Settings/Preferences | Tools | CodeGPT**. Paste your OpenAI API key into the field and click `Apply/OK`.
63107

64-
You can configure the key by going to the plugin's settings via the `File | Settings/Preferences | Tools | CodeGPT`.
65-
On the settings panel simply click on the `API key` field, paste the key obtained from the OpenAI website and click `Apply/OK`:
108+
### Azure OpenAI
66109

67-
![plugin-settings][plugin-settings]
110+
For Azure OpenAI services, you'll need to input three additional fields:
68111

69-
#### Azure OpenAI configuration
70-
Specifically for Azure OpenAI services, you will have to input three supplementary fields:
71-
* the `Resource Name`, which is the name of your Azure OpenAI Cognitive Services. It's the first part of the url you're provided to use the service: `https://my-resource-name.openai.azure.com/` -> use `my-resource-name`. You can find it in your Azure Cognitive Services page, under `Resource Management` -> `Resource Management` -> `Keys and Endpoints`.
72-
* the `Deployment ID`, which is the name of your Deployment. You can find it in the Azure AI Studio, under `Management` -> `Deployment` -> `Deployment Name` column in the table.
73-
* the `API Version`, I usually used the last non-preview version, which is currently `2023-05-15`.
74-
In addition to these, you need to input one of the two API Keys provided, found along with the `Resource Name`.
75-
76-
## Features
112+
- **Resource name**: The name of your Azure OpenAI Cognitive Services. It's the first part of the url you're provided to use the service: "https://**my-resource-name**.openai.azure.com/". You can find it in your Azure Cognitive Services page, under `Resource Management``Resource Management``Keys and Endpoints`.
113+
- **Deployment ID**: The name of your Deployment. You can find it in the Azure AI Studio, under `Management``Deployment``Deployment Name` column in the table.
114+
- **API version**: The most recent non-preview version.
77115

78-
The plugin provides several key features, such as:
116+
In addition to these, you need to input one of the two API Keys provided, found along with the `Resource Name`.
79117

80-
### Ask Anything
118+
### You.com (Free)
81119

82-
Ask anything you'd like.
120+
**You.com** is a search engine that summarizes the best parts of the internet for **you**, with private ads and with privacy options.
83121

84-
<p align="center">
85-
<img src="docs/assets/gif/ask-anything.gif" alt="animated" />
86-
</p>
122+
**You⚡Pro**
87123

88-
### Select and Ask
124+
Use the **CodeGPT** coupon for a free month of unlimited GPT-4 usage.
89125

90-
Ask anything related to your selected code.
126+
Check out the full [feature list](https://about.you.com/hc/youpro/what-features-are-included-in-youpro/) for more details.
91127

92-
<p align="center">
93-
<img src="docs/assets/gif/custom-prompt.gif" />
94-
</p>
128+
### LLaMA C/C++ Port (Free, Local)
95129

96-
### Replace Generated Code
130+
> **Note**: Currently supported only on Linux and MacOS.
97131
98-
Instantly replace a selected code block in the editor with suggested code generated by AI.
132+
The main goal of `llama.cpp` is to run the LLaMA model using 4-bit integer quantization on a MacBook.
99133

100-
<p align="center">
101-
<img src="docs/assets/gif/replace-code.gif" />
102-
</p>
134+
#### Getting Started
103135

104-
### Regenerate Response
136+
1. **Select the Model**: Depending on your hardware capabilities, choose the appropriate model from the provided list. Once selected, click on the `Download Model` link. A progress bar will appear, indicating the download process.
105137

106-
Expected a different answer? Re-generate any response of your choosing.
138+
2. **Start the Server**: After successfully downloading the model, initiate the server by clicking on the `Start Server` button. A status message will be displayed, indicating that the server is starting up.
107139

108-
<p align="center">
109-
<img src="docs/assets/gif/regenerate.gif" />
110-
</p>
140+
3. **Apply Settings**: With the server running, you can now apply the settings to start using the features. Click on the `Apply/OK` button to save your settings and start using the application.
111141

112-
### Other features
142+
<img alt="animated" style="max-width: 100%; width: 600px;" src="https://github.com/carlrobertoh/CodeGPT/raw/master/docs/assets/llama-settings.png" />
113143

114-
- **Conversation History** - View recent conversation history and restore previous sessions, making it easy to pick up where you left off
115-
- **Concurrent conversations** - Chat with the AI in multiple tabs simultaneously
116-
- **Seamless conversations** - Chat with the AI regardless of the maximum token limitations
117-
- **Predefined Actions** - Create your own editor actions or override the existing ones, saving time rewriting the same prompt repeatedly
144+
> **Note**: If you're already running a server and wish to configure the plugin against that, then simply select the port and click `Apply/OK`.
118145
119146
### Running locally
120147

‎docs/assets/chat-with-ai.png

1.85 MB
Loading
1.58 MB
Loading

‎docs/assets/llama-server-running.png

21.2 KB
Loading

‎docs/assets/llama-settings.png

392 KB
Loading
184 KB
Loading
20.5 KB
Loading

‎docs/assets/model-selection.png

245 KB
Loading

0 commit comments

Comments
 (0)
Please sign in to comment.