gpt4all/gpt4all-bindings/cli
cosmic-snow 828d83094b
docs: replace default model & link to wiki in CLI readme (#2719)
Signed-off-by: cosmic-snow <134004613+cosmic-snow@users.noreply.github.com>
2024-08-04 19:44:01 -04:00
..
app.py add min_p sampling parameter (#2014) 2024-02-24 17:51:34 -05:00
developer_notes.md CLI Improvements (#1021) 2023-06-23 12:09:31 -07:00
README.md docs: replace default model & link to wiki in CLI readme (#2719) 2024-08-04 19:44:01 -04:00

GPT4All Command-Line Interface (CLI)

GPT4All on the command-line.

More details on the wiki.

Quickstart

The CLI is based on the gpt4all Python bindings and the typer package.

The following shows one way to get started with the CLI, the documentation has more information. Typically, you will want to replace python with python3 on Unix-like systems and py -3 on Windows. Also, it's assumed you have all the necessary Python components already installed.

The CLI is a self-contained Python script named app.py (download). As long as its package dependencies are present, you can download and run it from wherever you like.

# optional but recommended: create and use a virtual environment
python -m venv gpt4all-cli

Windows and Unix-like systems differ slightly in how you activate a virtual environment:

  • Unix-like, typically: . gpt4all-cli/bin/activate
  • Windows: gpt4all-cli\Scripts\activate

Then:

# pip-install the necessary packages; omit '--user' if using a virtual environment
python -m pip install --user --upgrade gpt4all typer
# run the CLI
python app.py repl

By default, it will automatically download the Mistral Instruct model to .cache/gpt4all/ in your user directory, if necessary.

If you have already saved a model beforehand, specify its path with the -m/--model argument, for example:

python app.py repl --model /home/user/my-gpt4all-models/mistral-7b-instruct-v0.1.Q4_0.gguf