Access large language models from the command-line
Find a file
Simon Willison 77cf56e54a
Initial CLI support and plugin hook for embeddings, refs #185
* Embeddings plugin hook + OpenAI implementation
* llm.get_embedding_model(name) function
* llm embed command, for returning embeddings or saving them to SQLite
* Tests using an EmbedDemo embedding model
* llm embed-models list and emeb-models default commands
* llm embed-db path and llm embed-db collections commands
2023-08-27 22:24:10 -07:00
.github Create stable branch from most recent release tag 2023-08-20 21:31:49 -07:00
docs Initial CLI support and plugin hook for embeddings, refs #185 2023-08-27 22:24:10 -07:00
llm Initial CLI support and plugin hook for embeddings, refs #185 2023-08-27 22:24:10 -07:00
tests Initial CLI support and plugin hook for embeddings, refs #185 2023-08-27 22:24:10 -07:00
.gitignore Set min/max constraints to float arguments 2023-07-26 10:59:09 -07:00
.readthedocs.yaml .readthedocs.yaml 2023-07-24 08:53:48 -07:00
Justfile 'just push' command pushes to git only if test/lint passes 2023-08-27 20:20:39 -07:00
LICENSE Initial prototype, refs #1 2023-04-01 14:28:24 -07:00
MANIFEST.in Don't include tests/ in the package 2023-07-01 11:45:00 -07:00
mypy.ini Initial CLI support and plugin hook for embeddings, refs #185 2023-08-27 22:24:10 -07:00
pytest.ini Fix error on pydantic 1.10.2 - refs #169 2023-08-20 23:16:10 -07:00
README.md Link to two more blog entries 2023-08-12 09:27:36 -07:00
ruff.toml Lint using Ruff, refs #78 2023-07-02 12:41:40 -07:00
setup.py Initial CLI support and plugin hook for embeddings, refs #185 2023-08-27 22:24:10 -07:00

LLM

PyPI Documentation Changelog Tests License Discord

A CLI utility and Python library for interacting with Large Language Models, including OpenAI, PaLM and local models installed on your own machine.

Full documentation: llm.datasette.io

Background on this project:

Installation

Install this tool using pip:

pip install llm

Or using Homebrew:

brew install llm

Detailed installation instructions.

Getting started

If you have an OpenAI API key you can get started using the OpenAI models right away.

As an alternative to OpenAI, you can install plugins to access models by other providers, including models that can be installed and run on your own device.

Save your OpenAI API key like this:

llm keys set openai

This will prompt you for your key like so:

llm keys set openai
Enter key: <paste here>

Now that you've saved a key you can run a prompt like this:

llm "Five cute names for a pet penguin"
1. Waddles
2. Pebbles
3. Bubbles
4. Flappy
5. Chilly

Read the usage instructions for more.

Using a system prompt

You can use the -s/--system option to set a system prompt, providing instructions for processing other input to the tool.

To describe how the code a file works, try this:

cat mycode.py | llm -s "Explain this code"

Help

For help, run:

llm --help

You can also use:

python -m llm --help