summaryrefslogtreecommitdiffstats
path: root/docs/local.md
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--docs/local.md164
1 files changed, 164 insertions, 0 deletions
diff --git a/docs/local.md b/docs/local.md
new file mode 100644
index 00000000..2cedd1a9
--- /dev/null
+++ b/docs/local.md
@@ -0,0 +1,164 @@
+
+### G4F - Local Usage Guide
+
+
+### Table of Contents
+1. [Introduction](#introduction)
+2. [Required Dependencies](#required-dependencies)
+3. [Basic Usage Example](#basic-usage-example)
+4. [Supported Models](#supported-models)
+5. [Performance Considerations](#performance-considerations)
+6. [Troubleshooting](#troubleshooting)
+
+#### Introduction
+This guide explains how to use g4f to run language models locally. G4F (GPT4Free) allows you to interact with various language models on your local machine, providing a flexible and private solution for natural language processing tasks.
+
+## Usage
+
+#### Local inference
+How to use g4f to run language models locally
+
+#### Required dependencies
+**Make sure to install the required dependencies by running:**
+```bash
+pip install g4f[local]
+```
+or
+```bash
+pip install -U gpt4all
+```
+
+
+
+#### Basic usage example
+```python
+from g4f.local import LocalClient
+
+client = LocalClient()
+response = client.chat.completions.create(
+ model = 'orca-mini-3b',
+ messages = [{"role": "user", "content": "hi"}],
+ stream = True
+)
+
+for token in response:
+ print(token.choices[0].delta.content or "")
+```
+
+Upon first use, there will be a prompt asking you if you wish to download the model. If you respond with `y`, g4f will go ahead and download the model for you.
+
+You can also manually place supported models into `./g4f/local/models/`
+
+
+**You can get a list of the current supported models by running:**
+```python
+from g4f.local import LocalClient
+
+client = LocalClient()
+client.list_models()
+```
+
+```json
+{
+ "mistral-7b": {
+ "path": "mistral-7b-openorca.gguf2.Q4_0.gguf",
+ "ram": "8",
+ "prompt": "<|im_start|>user\n%1<|im_end|>\n<|im_start|>assistant\n",
+ "system": "<|im_start|>system\nYou are MistralOrca, a large language model trained by Alignment Lab AI. For multi-step problems, write out your reasoning for each step.\n<|im_end|>"
+ },
+ "mistral-7b-instruct": {
+ "path": "mistral-7b-instruct-v0.1.Q4_0.gguf",
+ "ram": "8",
+ "prompt": "[INST] %1 [/INST]",
+ "system": None
+ },
+ "gpt4all-falcon": {
+ "path": "gpt4all-falcon-newbpe-q4_0.gguf",
+ "ram": "8",
+ "prompt": "### Instruction:\n%1\n### Response:\n",
+ "system": None
+ },
+ "orca-2": {
+ "path": "orca-2-13b.Q4_0.gguf",
+ "ram": "16",
+ "prompt": None,
+ "system": None
+ },
+ "wizardlm-13b": {
+ "path": "wizardlm-13b-v1.2.Q4_0.gguf",
+ "ram": "16",
+ "prompt": None,
+ "system": None
+ },
+ "nous-hermes-llama2": {
+ "path": "nous-hermes-llama2-13b.Q4_0.gguf",
+ "ram": "16",
+ "prompt": "### Instruction:\n%1\n### Response:\n",
+ "system": None
+ },
+ "gpt4all-13b-snoozy": {
+ "path": "gpt4all-13b-snoozy-q4_0.gguf",
+ "ram": "16",
+ "prompt": None,
+ "system": None
+ },
+ "mpt-7b-chat": {
+ "path": "mpt-7b-chat-newbpe-q4_0.gguf",
+ "ram": "8",
+ "prompt": "<|im_start|>user\n%1<|im_end|>\n<|im_start|>assistant\n",
+ "system": "<|im_start|>system\n- You are a helpful assistant chatbot trained by MosaicML.\n- You answer questions.\n- You are excited to be able to help the user, but will refuse to do anything that could be considered harmful to the user.\n- You are more than just an information source, you are also able to write poetry, short stories, and make jokes.<|im_end|>"
+ },
+ "orca-mini-3b": {
+ "path": "orca-mini-3b-gguf2-q4_0.gguf",
+ "ram": "4",
+ "prompt": "### User:\n%1\n### Response:\n",
+ "system": "### System:\nYou are an AI assistant that follows instruction extremely well. Help as much as you can.\n\n"
+ },
+ "replit-code-3b": {
+ "path": "replit-code-v1_5-3b-newbpe-q4_0.gguf",
+ "ram": "4",
+ "prompt": "%1",
+ "system": None
+ },
+ "starcoder": {
+ "path": "starcoder-newbpe-q4_0.gguf",
+ "ram": "4",
+ "prompt": "%1",
+ "system": None
+ },
+ "rift-coder-7b": {
+ "path": "rift-coder-v0-7b-q4_0.gguf",
+ "ram": "8",
+ "prompt": "%1",
+ "system": None
+ },
+ "all-MiniLM-L6-v2": {
+ "path": "all-MiniLM-L6-v2-f16.gguf",
+ "ram": "1",
+ "prompt": None,
+ "system": None
+ },
+ "mistral-7b-german": {
+ "path": "em_german_mistral_v01.Q4_0.gguf",
+ "ram": "8",
+ "prompt": "USER: %1 ASSISTANT: ",
+ "system": "Du bist ein hilfreicher Assistent. "
+ }
+}
+```
+
+#### Performance Considerations
+**When running language models locally, consider the following:**
+ - RAM requirements vary by model size (see the 'ram' field in the model list).
+ - CPU/GPU capabilities affect inference speed.
+ - Disk space is needed to store the model files.
+
+#### Troubleshooting
+**Common issues and solutions:**
+ 1. **Model download fails**: Check your internet connection and try again.
+ 2. **Out of memory error**: Choose a smaller model or increase your system's RAM.
+ 3. **Slow inference**: Consider using a GPU or a more powerful CPU.
+
+
+
+[Return to Home](/)