Skip to content

Commit 822eab0

Browse files
committed
Updated docs
1 parent 8f60b28 commit 822eab0

30 files changed

+299
-239
lines changed

README.md

Lines changed: 41 additions & 32 deletions
Large diffs are not rendered by default.

docs/source/attachments.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Files and attachments
33

44
Input (upload)
55
-------
6-
**PYGPT** makes it simple for users to upload files to the server and send them to the model for tasks like analysis, similar to attaching files in ``ChatGPT``. There's a separate ``Files`` tab next to the text input area specifically for managing file uploads. Users can opt to have files automatically deleted after each upload or keep them on the list for repeated use.
6+
**PyGPT** makes it simple for users to upload files to the server and send them to the model for tasks like analysis, similar to attaching files in ``ChatGPT``. There's a separate ``Files`` tab next to the text input area specifically for managing file uploads. Users can opt to have files automatically deleted after each upload or keep them on the list for repeated use.
77

88
The attachment feature is available in both the ``Assistant`` and ``Vision`` modes.
99

@@ -14,7 +14,7 @@ The attachment feature is available in both the ``Assistant`` and ``Vision`` mod
1414

1515
Output (download, generation)
1616
---------------
17-
**PYGPT** enables the automatic download and saving of files created by the model. This is carried out in the background, with the files being saved to an ``output`` folder located within the user's working directory. To view or manage these files, users can navigate to the ``Output`` tab which features a file browser for this specific directory. Here, users have the interface to handle all files sent by the AI.
17+
**PyGPT** enables the automatic download and saving of files created by the model. This is carried out in the background, with the files being saved to an ``output`` folder located within the user's working directory. To view or manage these files, users can navigate to the ``Output`` tab which features a file browser for this specific directory. Here, users have the interface to handle all files sent by the AI.
1818

1919
This ``output`` directory is also where the application stores files that are generated locally by the AI, such as code files or any other outputs requested from the model. Users have the option to execute code directly from the stored files and read their contents, with the results fed back to the AI. This hands-off process is managed by the built-in plugin system and model-triggered commands.
2020

docs/source/conf.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@
66
# -- Project information -----------------------------------------------------
77
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
88

9-
project = 'PYGPT'
9+
project = 'PyGPT'
1010
copyright = '2023, pygpt.net'
1111
author = 'szczyglis-dev, Marcin Szczygliński'
12-
release = '2.0.27'
12+
release = '2.0.28'
1313

1414
# -- General configuration ---------------------------------------------------
1515
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

docs/source/context.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ Context and memory
33

44
Short and long-term memory
55
--------------------------
6-
**PYGPT** features a continuous chat mode that maintains a long context of the ongoing dialogue. It preserves the entire conversation history and automatically appends it to each new message (prompt) you send to the AI. Additionally, you have the flexibility to revisit past conversations whenever you choose. The application keeps a record of your chat history, allowing you to resume discussions from the exact point you stopped.
6+
**PyGPT** features a continuous chat mode that maintains a long context of the ongoing dialogue. It preserves the entire conversation history and automatically appends it to each new message (prompt) you send to the AI. Additionally, you have the flexibility to revisit past conversations whenever you choose. The application keeps a record of your chat history, allowing you to resume discussions from the exact point you stopped.
77

88

99
Handling multiple contexts
1010
---------------------------
11-
On the left side of the application interface, there is a panel that displays a list of saved conversations. You can save numerous contexts and switch between them with ease. This feature allows you to revisit and continue from any point in a previous conversation. **PYGPT** automatically generates a summary for each context, akin to the way ``ChatGPT`` operates and gives you the option to modify these titles itself.
11+
On the left side of the application interface, there is a panel that displays a list of saved conversations. You can save numerous contexts and switch between them with ease. This feature allows you to revisit and continue from any point in a previous conversation. **PyGPT** automatically generates a summary for each context, akin to the way ``ChatGPT`` operates and gives you the option to modify these titles itself.
1212

1313
.. image:: images/v2_context_list.png
1414
:width: 400

docs/source/images.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Images generation (DALL-E 3)
33

44
DALL-E 3
55
---------
6-
PYGPT enables quick and straightforward image creation with ``DALL-E 3``.
6+
PyGPT enables quick and straightforward image creation with ``DALL-E 3``.
77
The older model version, ``DALL-E 2``, is also accessible. Generating images is akin to a chat conversation -
88
a user's prompt triggers the generation, followed by downloading, saving to the computer,
99
and displaying the image onscreen.

docs/source/index.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
1-
.. PYGPT documentation master file, created by
1+
.. PyGPT documentation master file, created by
22
sphinx-quickstart on Fri Mar 24 06:46:09 2023.
33
You can adapt this file completely to your liking, but it should at least
44
contain the root `toctree` directive.
55
6-
PYGPT v2 - pygpt.net
6+
PyGPT v2 - pygpt.net
77
====================
88

99
| **Last update:** 2023-12-14 12:00
1010
| **Project website:** https://pygpt.net
1111
| **GitHub:** https://github.com/szczyglis-dev/py-gpt
1212
| **PyPI:** https://pypi.org/project/pygpt-net
13-
| **Release:** 2.0.27 (2023-12-14)
13+
| **Release:** 2.0.28 (2023-12-14)
1414
1515
.. toctree::
1616
:maxdepth: 3

docs/source/intro.rst

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,15 @@ Introduction
44
Overview
55
----------------
66

7-
**PYGPT** is **all-in-one** Desktop AI Assistant that provides direct interaction with OpenAI language models, including ``GPT-4``, ``GPT-4 Vision``, and ``GPT-3.5``, through the ``OpenAI API``. The application also integrates with alternative LLMs, like those available on ``HuggingFace``, by utilizing ``Langchain``.
7+
**PyGPT** is **all-in-one** Desktop AI Assistant that provides direct interaction with OpenAI language models, including ``GPT-4``, ``GPT-4 Vision``, and ``GPT-3.5``, through the ``OpenAI API``. The application also integrates with alternative LLMs, like those available on ``HuggingFace``, by utilizing ``Langchain``.
88

9-
This assistant offers multiple modes of operation such as chat, assistants, completions, and image-related tasks using ``DALL-E 3`` for generation and ``GPT-4 Vision`` for analysis. **PYGPT** has filesystem capabilities for file I/O, can generate and run Python code, execute system commands, and manage file transfers. It also allows models to perform web searches with the ``Google Custom Search API``.
9+
This assistant offers multiple modes of operation such as chat, assistants, completions, and image-related tasks using ``DALL-E 3`` for generation and ``GPT-4 Vision`` for analysis. **PyGPT** has filesystem capabilities for file I/O, can generate and run Python code, execute system commands, and manage file transfers. It also allows models to perform web searches with the ``Google Custom Search API``.
1010

11-
For audio interactions, **PYGPT** includes speech synthesis using the ``Microsoft Azure Text-to-Speech API`` and ``OpenAI's TTS API``. Additionally, it features speech recognition capabilities provided by ``OpenAI Whisper``, enabling the application to understand spoken commands and transcribe audio inputs into text. It features context memory with save and load functionality, enabling users to resume interactions from predefined points in the conversation. Prompt creation and management are streamlined through an intuitive preset system.
11+
For audio interactions, **PyGPT** includes speech synthesis using the ``Microsoft Azure Text-to-Speech API`` and ``OpenAI's TTS API``. Additionally, it features speech recognition capabilities provided by ``OpenAI Whisper``, enabling the application to understand spoken commands and transcribe audio inputs into text. It features context memory with save and load functionality, enabling users to resume interactions from predefined points in the conversation. Prompt creation and management are streamlined through an intuitive preset system.
1212

13-
**PYGPT**'s functionality extends through plugin support, allowing for custom enhancements. Its multi-modal capabilities make it an adaptable tool for a range of AI-assisted operations, such as text-based interactions, system automation, daily assisting, vision applications, natural language processing, code generation and image creation.
13+
**PyGPT**'s functionality extends through plugin support, allowing for custom enhancements. Its multi-modal capabilities make it an adaptable tool for a range of AI-assisted operations, such as text-based interactions, system automation, daily assisting, vision applications, natural language processing, code generation and image creation.
1414

15-
Multiple operation modes are included, such as chatbot, text completion, assistant, vision, Langchain, commands execution and image generation, making **PYGPT** a comprehensive tool for many AI-driven tasks.
15+
Multiple operation modes are included, such as chatbot, text completion, assistant, vision, Langchain, commands execution and image generation, making **PyGPT** a comprehensive tool for many AI-driven tasks.
1616

1717
.. image:: images/v2_main.png
1818
:width: 800
@@ -54,7 +54,7 @@ The application is free, open-source, and runs on PCs with ``Windows 10``, ``Win
5454
The full Python source code is available on ``GitHub``.
5555

5656

57-
**PYGPT uses the user's API key - to use the application,
57+
**PyGPT uses the user's API key - to use the application,
5858
you must have a registered OpenAI account and your own API key.**
5959

6060
.. note::

docs/source/models.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ and those supported by ``Langchain`` to this file. Configuration for Langchain w
88
Adding custom LLMs via Langchain
99
--------------------------------
1010

11-
To add a new model using the Langchain wrapper in **PYGPT**, insert the model's configuration details into the ``models.json`` file. This should include the model's name, its supported modes (either ``chat``, ``completion``, or both), the LLM provider (which can be either e.g. ``OpenAI`` or ``HuggingFace``), and, if you are using a ``HuggingFace`` model, an optional ``API KEY``.
11+
To add a new model using the Langchain wrapper in **PyGPT**, insert the model's configuration details into the ``models.json`` file. This should include the model's name, its supported modes (either ``chat``, ``completion``, or both), the LLM provider (which can be either e.g. ``OpenAI`` or ``HuggingFace``), and, if you are using a ``HuggingFace`` model, an optional ``API KEY``.
1212

1313
Example of models configuration - ``models.json``:
1414

@@ -130,4 +130,4 @@ To add support for any provider not included by default, simply create your own
130130
launcher.run()
131131
132132
133-
To integrate your own model or provider into **PYGPT**, you can reference the sample classes located in the ``llm`` directory of the application. These samples can act as an example for your custom class. Ensure that your custom wrapper class includes two essential methods: ``chat`` and ``completion``. These methods should return the respective objects required for the model to operate in ``chat`` and ``completion`` modes.
133+
To integrate your own model or provider into **PyGPT**, you can reference the sample classes located in the ``llm`` directory of the application. These samples can act as an example for your custom class. Ensure that your custom wrapper class includes two essential methods: ``chat`` and ``completion``. These methods should return the respective objects required for the model to operate in ``chat`` and ``completion`` modes.

docs/source/modes.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Chat, completion, assistants and vision
33

44
Chat
55
----
6-
This mode in **PYGPT** mirrors ``ChatGPT``, allowing you to chat with models such as ``GPT-4``, ``GPT-4 Turbo``, ``GPT-3.5``, and ``GPT-3``. It's easy to switch models whenever you want. It works by using the ``ChatCompletion API``.
6+
This mode in **PyGPT** mirrors ``ChatGPT``, allowing you to chat with models such as ``GPT-4``, ``GPT-4 Turbo``, ``GPT-3.5``, and ``GPT-3``. It's easy to switch models whenever you want. It works by using the ``ChatCompletion API``.
77

88
The main part of the interface is a chat window where conversations appear. Right below that is where you type your messages. On the right side of the screen, there's a section to set up or change your system prompts. You can also save these setups as presets to quickly switch between different models or tasks.
99

@@ -33,9 +33,9 @@ Assistants
3333
----------
3434
This mode uses the new OpenAI's **Assistants API**.
3535

36-
This mode expands on the basic chat functionality by including additional external tools like a ``Code Interpreter`` for executing code, ``Retrieval Files`` for accessing files, and custom ``Functions`` for enhanced interaction and integration with other APIs or services. In this mode, you can easily upload and download files. **PYGPT** streamlines file management, enabling you to quickly upload documents and manage files created by the model.
36+
This mode expands on the basic chat functionality by including additional external tools like a ``Code Interpreter`` for executing code, ``Retrieval Files`` for accessing files, and custom ``Functions`` for enhanced interaction and integration with other APIs or services. In this mode, you can easily upload and download files. **PyGPT** streamlines file management, enabling you to quickly upload documents and manage files created by the model.
3737

38-
Setting up new assistants is simple - a single click is all it takes, and they instantly sync with the ``OpenAI API``. Importing assistants you've previously created with OpenAI into **PYGPT** is also a seamless process.
38+
Setting up new assistants is simple - a single click is all it takes, and they instantly sync with the ``OpenAI API``. Importing assistants you've previously created with OpenAI into **PyGPT** is also a seamless process.
3939

4040
.. image:: images/v2_mode_assistant.png
4141
:width: 800
@@ -84,7 +84,7 @@ into the application, allowing you to interact with any LLM by simply supplying
8484
file for the specific model. You can add as many models as you like; just list them in the configuration
8585
file named ``models.json``.
8686

87-
Available LLMs providers supported by **PYGPT**:
87+
Available LLMs providers supported by **PyGPT**:
8888

8989
* OpenAI
9090
* Azure OpenAI
@@ -96,4 +96,4 @@ Available LLMs providers supported by **PYGPT**:
9696
.. image:: images/v2_mode_langchain.png
9797
:width: 800
9898

99-
You have the ability to add custom model wrappers for models that are not available by default in **PYGPT**. To integrate a new model, you can create your own wrapper and register it with the application. Detailed instructions for this process are provided in the section titled ``Managing models / Adding models via Langchain``.
99+
You have the ability to add custom model wrappers for models that are not available by default in **PyGPT**. To integrate a new model, you can create your own wrapper and register it with the application. Detailed instructions for this process are provided in the section titled ``Managing models / Adding models via Langchain``.

docs/source/plugins.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ Allows system commands execution. *Default:* `True`
135135
Command: Custom Commands
136136
------------------------
137137

138-
With the ``Custom Commands`` plugin, you can integrate **PYGPT** with your operating system and scripts or applications. You can define an unlimited number of custom commands and instruct GPT on when and how to execute them. Configuration is straightforward, and **PYGPT** includes a simple tutorial command for testing and learning how it works:
138+
With the ``Custom Commands`` plugin, you can integrate **PyGPT** with your operating system and scripts or applications. You can define an unlimited number of custom commands and instruct GPT on when and how to execute them. Configuration is straightforward, and **PyGPT** includes a simple tutorial command for testing and learning how it works:
139139

140140
.. image:: images/v2_custom_cmd.png
141141
:width: 800
@@ -171,7 +171,7 @@ Here are some predefined system placeholders for use:
171171
- ``{_date}`` - current date in ``Y-m-d`` format
172172
- ``{_datetime}`` - current date and time in ``Y-m-d H:M:S`` format
173173
- ``{_file}`` - path to the file from which the command is invoked
174-
- ``{_home}`` - path to PYGPT's home/working directory
174+
- ``{_home}`` - path to PyGPT's home/working directory
175175

176176
You can connect predefined placeholders with your own params.
177177

@@ -187,11 +187,11 @@ With the setup above, every time you ask GPT to generate a song for you and save
187187
1. Generate a song.
188188
2. Locate your command.
189189
3. Execute the command by sending the song's title and text.
190-
4. The command will save the song text into a file named with the song's title in the PYGPT working directory.
190+
4. The command will save the song text into a file named with the song's title in the PyGPT working directory.
191191

192192
**Example tutorial command**
193193

194-
**PYGPT** provides simple tutorial command to show how it work, to run it just ask GPT for execute ``tutorial test command`` and it will show you how it works:
194+
**PyGPT** provides simple tutorial command to show how it work, to run it just ask GPT for execute ``tutorial test command`` and it will show you how it works:
195195

196196
.. code-block:: console
197197
@@ -204,7 +204,7 @@ With the setup above, every time you ask GPT to generate a song for you and save
204204
Command: Google Web Search
205205
--------------------------
206206

207-
**PYGPT** lets you connect GPT to the internet and carry out web searches in real time as you make queries.
207+
**PyGPT** lets you connect GPT to the internet and carry out web searches in real time as you make queries.
208208

209209
To activate this feature, turn on the ``Command: Google Web Search`` plugin found in the ``Plugins`` menu.
210210

@@ -218,7 +218,7 @@ After registering an account, create a new project and select it from the list o
218218
https://programmablesearchengine.google.com/controlpanel/all
219219

220220
After selecting your project, you need to enable the ``Whole Internet Search`` option in its settings.
221-
Then, copy the following two items into PYGPT:
221+
Then, copy the following two items into PyGPT:
222222

223223
* Api Key
224224
* CX ID
@@ -232,7 +232,7 @@ These data must be configured in the appropriate fields in the ``Plugins / Setti
232232
Audio Output (Microsoft Azure)
233233
--------------------------
234234

235-
**PYGPT** implements voice synthesis using the ``Microsoft Azure Text-To-Speech`` API.
235+
**PyGPT** implements voice synthesis using the ``Microsoft Azure Text-To-Speech`` API.
236236
This feature requires to have an ``Microsoft Azure`` API Key.
237237
You can get API KEY for free from here: https://azure.microsoft.com/en-us/services/cognitive-services/text-to-speech
238238

@@ -390,7 +390,7 @@ current date and time in real-time. *Default:* `Current time is {time}.`
390390
Creating Your Own Plugins
391391
--------------------------
392392

393-
You can create your own plugin for **PYGPT** at any time. The plugin can be written in Python and then registered with the application just before launching it. All plugins included with the app are stored in the ``plugin`` directory - you can use them as coding examples for your own plugins. Then, you can create your own and register it in the system using:
393+
You can create your own plugin for **PyGPT** at any time. The plugin can be written in Python and then registered with the application just before launching it. All plugins included with the app are stored in the ``plugin`` directory - you can use them as coding examples for your own plugins. Then, you can create your own and register it in the system using:
394394

395395
.. code-block:: python
396396

0 commit comments

Comments
 (0)