Skip to content

Commit f8bd187

Browse files
committed
docs: update readme and plugin description
1 parent 46b88a4 commit f8bd187

9 files changed

+87
-57
lines changed

DESCRIPTION.md

Lines changed: 12 additions & 11 deletions
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

Lines changed: 75 additions & 46 deletions
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,62 @@
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+
Ask anything you'd like.
51+
52+
<p align="center">
53+
<img src="docs/assets/chat-with-ai.png" alt="animated" />
54+
</p>
55+
56+
### Generate Git Commit Messages
57+
58+
<p align="center">
59+
<img src="docs/assets/generate-commit-message.png" />
60+
</p>
61+
62+
### Method name suggestions
63+
64+
<p align="center">
65+
<img src="docs/assets/method-name-suggestions.png" />
66+
</p>
67+
68+
### Multiple providers
69+
70+
<p align="center">
71+
<img src="docs/assets/model-selection.png" />
72+
</p>
73+
74+
### Other features
75+
76+
- **Conversation History** - View recent conversation history and restore previous sessions, making it easy to pick up where you left off
77+
- **Concurrent conversations** - Chat with AI in multiple tabs simultaneously
78+
- **Seamless conversations** - Chat with AI regardless of the maximum token limitations
79+
- **Predefined Actions** - Create your own editor actions or override the existing ones, saving time rewriting the same prompt repeatedly
4280

4381
## Getting Started
4482

45-
To get started, follow these simple steps:
83+
1. **Download the Plugin**
84+
85+
2. **Choose Your Preferred Service**:
86+
87+
a) **OpenAI** - Requires authentication via OpenAI API key.
88+
89+
b) **Azure** - Requires authentication via Active Directory or API key.
4690

47-
### Prerequisites
91+
c) **You.com** - A free, web-connected service with an optional upgrade to You⚡Pro for enhanced features.
4892

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].
93+
d) **LLaMA C/C++ Port** - Recommended to have a decent computer to handle the computational requirements of running inference.
94+
> **Note**: Currently supported only on Linux and MacOS.
95+
96+
3. **Start Using the Features**
5197

5298
### Installation
5399

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

58104
![marketplace][marketplace-img]
59105

60-
### API Key Configuration
61-
62-
After the plugin has been successfully installed, the API key needs to be configured.
106+
### OpenAI
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+
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`.
66109

67-
![plugin-settings][plugin-settings]
110+
### Azure OpenAI
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`.
112+
For Azure OpenAI services, you'll need to input three additional fields:
75113

76-
## Features
114+
- **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`.
115+
- **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.
116+
- **API version**: The most recent non-preview version.
77117

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

80-
### Ask Anything
120+
### You.com (Free)
81121

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

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

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

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

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

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

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

104-
### Regenerate Response
138+
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.
105139

106-
Expected a different answer? Re-generate any response of your choosing.
140+
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.
107141

108-
<p align="center">
109-
<img src="docs/assets/gif/regenerate.gif" />
110-
</p>
142+
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.
111143

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

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
146+
> **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`.
118147
119148
### Running locally
120149

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)