Harrison/gpt4all (#2366)

Co-authored-by: William FH <13333726+hinthornw@users.noreply.github.com>
Co-authored-by: Eugene Yurtsev <eyurtsev@gmail.com>

docs/ecosystem/gpt4all.md

@@ -0,0 +1,37 @@
+# GPT4All
+
+This page covers how to use the `GPT4All` wrapper within LangChain.
+It is broken into two parts: installation and setup, and then usage with an example.
+
+## Installation and Setup
+- Install the Python package with `pip install pyllamacpp`
+- Download a [GPT4All model](https://github.com/nomic-ai/gpt4all) and place it in your desired directory
+
+## Usage
+
+### GPT4All
+
+To use the GPT4All wrapper, you need to provide the path to the pre-trained model file and the model's configuration.
+```python
+from langchain.llms import GPT4All
+
+# Instantiate the model
+model = GPT4All(model="./models/gpt4all-model.bin", n_ctx=512, n_threads=8)
+
+# Generate text
+response = model("Once upon a time, ")
+```
+
+You can also customize the generation parameters, such as n_predict, temp, top_p, top_k, and others.
+
+Example:
+
+```python
+model = GPT4All(model="./models/gpt4all-model.bin", n_predict=55, temp=0)
+response = model("Once upon a time, ")
+```
+## Model File
+
+You can find links to model file downloads at the [GPT4all](https://github.com/nomic-ai/gpt4all) repository. They will need to be converted to `ggml` format to work, as specified in the [pyllamacpp](https://github.com/nomic-ai/pyllamacpp) repository.
+
+For a more detailed walkthrough of this, see [this notebook](../modules/models/llms/integrations/gpt4all.ipynb)

docs/modules/models/llms/integrations/gpt4all.ipynb

@@ -0,0 +1,85 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# OpenAI\n",
+    "\n",
+    "This example goes over how to use LangChain to interact with GPT4All models"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install pyllamacpp"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from langchain.llms import GPT4All\n",
+    "from langchain import PromptTemplate, LLMChain"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "template = \"\"\"Question: {question}\n",
+    "\n",
+    "Answer: Let's think step by step.\"\"\"\n",
+    "\n",
+    "prompt = PromptTemplate(template=template, input_variables=[\"question\"])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# You'll need to download a compatible model and convert it to ggml.\n",
+    "# See: https://github.com/nomic-ai/gpt4all for more information.\n",
+    "llm = GPT4All(model_path=\"./models/gpt4all-model.bin\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "llm_chain = LLMChain(prompt=prompt, llm=llm)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "question = \"What NFL team won the Super Bowl in the year Justin Bieber was born?\"\n",
+    "\n",
+    "llm_chain.run(question)"
+   ]
+  }
+ ],
+ "metadata": {
+  "language_info": {
+   "name": "python"
+  },
+  "orig_nbformat": 4
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}