Metadata-Version: 2.1
Name: llm
Version: 0.4
Summary: Access large language models from the command-line
Home-page: https://github.com/simonw/llm
Author: Simon Willison
License: Apache License, Version 2.0
Project-URL: Documentation, https://llm.datasette.io/
Project-URL: Issues, https://github.com/simonw/llm/issues
Project-URL: CI, https://github.com/simonw/llm/actions
Project-URL: Changelog, https://github.com/simonw/llm/releases
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click
Requires-Dist: openai
Requires-Dist: click-default-group-wheel
Requires-Dist: sqlite-utils
Requires-Dist: pydantic
Requires-Dist: PyYAML
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: requests-mock ; extra == 'test'

# llm

[![PyPI](https://img.shields.io/pypi/v/llm.svg)](https://pypi.org/project/llm/)
[![Changelog](https://img.shields.io/github/v/release/simonw/llm?include_prereleases&label=changelog)](https://github.com/simonw/llm/releases)
[![Tests](https://github.com/simonw/llm/workflows/Test/badge.svg)](https://github.com/simonw/llm/actions?query=workflow%3ATest)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/simonw/llm/blob/master/LICENSE)

Access large language models from the command-line

See [llm, ttok and strip-tags—CLI tools for working with ChatGPT and other LLMs](https://simonwillison.net/2023/May/18/cli-tools-for-llms/) for more on this project.

## Installation

Install this tool using `pip`:

    pip install llm

[Detailed installation instructions](https://llm.datasette.io/en/stable/installation.html).

## Getting started

First, create an OpenAI API key and save it to the tool like this:

```
llm keys set openai
```
This will prompt you for your key like so:
```
$ llm keys set openai
Enter key:
```

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](https://llm.datasette.io/en/stable/usage.html) for more.

## Help

For help, run:

    llm --help

You can also use:

    python -m llm --help
