# Gpt4All Web UI ![GitHub license](https://img.shields.io/github/license/nomic-ai/GPT4All-ui) ![GitHub issues](https://img.shields.io/github/issues/nomic-ai/GPT4All-ui) ![GitHub stars](https://img.shields.io/github/stars/nomic-ai/GPT4All-ui) ![GitHub forks](https://img.shields.io/github/forks/nomic-ai/GPT4All-ui) This is a Flask web application that provides a chat UI for interacting with the GPT4All chatbot. [Discord server](https://discord.gg/DZ4wsgg4) ## What is GPT4All GPT4All is a language model built by Nomic-AI, a company specializing in natural language processing. The app uses Nomic-AI's library to communicate with the GPT4All model, which runs locally on the user's PC. For more details about this project, head on to their [github repository](https://github.com/nomic-ai/gpt4all). You can also reald their [Technical report](https://s3.amazonaws.com/static.nomic.ai/gpt4all/2023_GPT4All_Technical_Report.pdf) for more information about the training process, the database etc. The app allows users to send messages to the chatbot and view its responses in real-time. Additionally, users can export the entire chat history in text or JSON format. The model has just been released and it may evolve over time, this webui is meant for community to get easy and fully local access to a chatbot that may become better with time. ## UI screenshot ![image](https://user-images.githubusercontent.com/827993/229951093-27114d9f-0e1f-4d84-b103-e35cd3f9310d.png) ## Installation To install the app, follow these steps: 1. Clone the GitHub repository: ``` git clone https://github.com/nomic-ai/gpt4all-ui ``` 1. Navigate to the project directory: ``` cd GPT4All-ui ``` 1. Run the appropriate installation script for your platform: On Windows : ``` install.bat ``` - On linux/ Mac os ``` ./install.sh ``` On Linux/MacOS, if you have issues, refer more details are presented [here](docs/Linux_Osx_Install.md) These scripts will create a Python virtual environment and install the required dependencies. It will also download the models and install them. Now you're ready to work! ## Usage For simple newbies on Windows: ```cmd run.bat ``` For simple newbies on Linux/MacOsX: ```bash run.sh ``` if you want more control on your launch, you can activate your environment: On Windows: ```cmd env/Scripts/activate.bat ``` On Linux/MacOs: ```cmd source venv/bin/activate ``` Now you are ready to customize your Bot. To run the Flask server, execute the following command: ```bash python app.py [--port PORT] [--host HOST] [--temp TEMP] [--n-predict N_PREDICT] [--top-k TOP_K] [--top-p TOP_P] [--repeat-penalty REPEAT_PENALTY] [--repeat-last-n REPEAT_LAST_N] [--ctx-size CTX_SIZE] ``` On Linux/MacOS more details are [here](docs/Linux_Osx_Usage.md) ## Options * `--port`: the port on which to run the server (default: 9600) * `--host`: the host address on which to run the server (default: localhost) * `--temp`: the sampling temperature for the model (default: 0.1) * `--n-predict`: the number of tokens to predict at a time (default: 128) * `--top-k`: the number of top-k candidates to consider for sampling (default: 40) * `--top-p`: the cumulative probability threshold for top-p sampling (default: 0.90) * `--repeat-penalty`: the penalty to apply for repeated n-grams (default: 1.3) * `--repeat-last-n`: the number of tokens to use for detecting repeated n-grams (default: 64) * `--ctx-size`: the maximum context size to use for generating responses (default: 2048) Note: All options are optional, and have default values. Once the server is running, open your web browser and navigate to http://localhost:9600 (or http://your host name:your port number if you have selected different values for those) to access the chatbot UI. To use the app, open a web browser and navigate to this URL. Make sure to adjust the default values and descriptions of the options to match your specific application. ## Contribute This is an open-source project by the community for the community. Our chatbot is a UI wrapper for Nomic AI's model, which enables natural language processing and machine learning capabilities. We welcome contributions from anyone who is interested in improving our chatbot. Whether you want to report a bug, suggest a feature, or submit a pull request, we encourage you to get involved and help us make our chatbot even better. Before contributing, please take a moment to review our [code of conduct](./CODE_OF_CONDUCT.md). We expect all contributors to abide by this code of conduct, which outlines our expectations for respectful communication, collaborative development, and innovative contributions. ### Reporting Bugs If you find a bug or other issue with our chatbot, please report it by [opening an issue](https://github.com/your-username/your-chatbot/issues/new). Be sure to provide as much detail as possible, including steps to reproduce the issue and any relevant error messages. ### Suggesting Features If you have an idea for a new feature or improvement to our chatbot, we encourage you to [open an issue](https://github.com/your-username/your-chatbot/issues/new) to discuss it. We welcome feedback and ideas from the community and will consider all suggestions that align with our project goals. ### Contributing Code If you want to contribute code to our chatbot, please follow these steps: 1. Fork the repository and create a new branch for your changes. 2. Make your changes and ensure that they follow our coding conventions. 3. Test your changes to ensure that they work as expected. 4. Submit a pull request with a clear description of your changes and the problem they solve. We will review your pull request as soon as possible and provide feedback on any necessary changes. We appreciate your contributions and look forward to working with you! Please note that all contributions are subject to review and approval by our project maintainers. We reserve the right to reject any contribution that does not align with our project goals or standards. ## Future Plans Here are some of the future plans for this project: **Enhanced control of chatbot parameters:** We plan to improve the user interface (UI) of the chatbot to allow users to control the parameters of the chatbot such as temperature and other variables. This will give users more control over the chatbot's responses, and allow for a more customized experience. **Extension system for plugins:** We are also working on an extension system that will allow developers to create plugins for the chatbot. These plugins will be able to add new features and capabilities to the chatbot, and allow for greater customization of the chatbot's behavior. **Enhanced UI with themes and skins:** Additionally, we plan to enhance the user interface of the chatbot to allow for themes and skins. This will allow users to personalize the appearance of the chatbot, and make it more visually appealing. We are excited about these future plans for the project and look forward to implementing them in the near future. Stay tuned for updates! ## License This project is licensed under the Apache 2.0 License. See the [LICENSE](https://github.com/nomic-ai/GPT4All-ui/blob/main/LICENSE) file for details.