Skip to main content

Command-line tool to use Large Language Models in your shell,including OpenAI, Anthropic, PalM, Mistral, Cohere, and more.

Project description

LLMsh

PyPI License

Command-line tool to use Large Language Models in your shell. Supported providers include OpenAI, Anthropic, PalM, Mistral, Cohere, and more.

Perfect for usage in scripts, automation, or as a CHAT inside command-line.

This is an alpha version and a work in progress.

Installation

pip install llmsh

Configure

# Set your OpenAI key in the current shell
export OPENAI_API_KEY="sk-xxxxxx"

Usage

Prompt mode

$ llmsh "Translate to Polish: What a good day"
Jaki dobry dzień

Pipe output to LLM

$ echo "Translate to Polish: What a good day" | llmsh
Jaki dobry dzień

Combine pipe and prompt

$ echo "Translate to Polish:" | llmsh "What a good day"
Jaki dobry dzień

Use a file as a prompt

$ echo "Who is Dora?" > prompt.txt
$ llmsh "@prompt.txt"
Dora is the main character from the animated television series "Dora the Explorer", produced by Nickelodeon. Dora is a young Latina girl who embarks  
on numerous adventures in an imaginative world with her backpack and her talking monkey companion named Boots. 

Specify a system prompt

$ llmsh "@prompt.txt" -s "You are Dora the Explorer. Help me learn Spanish"
¡Hola! I'm Dora. I help kids to learn Spanish through fun       
adventures. I explore various environments with my talking backpack and monkey friend, Boots. Do you want to learn some Spanish words with me today? 

System prompt can also be a file: -s @system.txt.

Interactive chat mode

$ llmsh -i
> What is the time difference between New York and Gdansk?
New York is typically 6 hours behind Gdansk. However, due to daylight saving
changes, this can occasionally vary.

> It is April. 
In April, Daylight Saving Time is active in both locations. The time
difference remains the same. New York is 6 hours behind Gdansk.

>
# Press Ctrl+D (Ctrl+Z on Windows), or type exit or quit to quit the chat.

You can also use a file as a prompt: -i @prompt.txt. As well as a system prompt: -i -s "You are a helpful assistant.", which can also be sourced from a file.

Piping is not supported in interactive mode.

Roadmap

https://github.com/vduseev/llmsh/labels/feature

License

Copyright 2024 Vagiz Duseev

Apache 2.0 License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

llmsh-0.1.tar.gz (11.8 kB view hashes)

Uploaded Source

Built Distribution

llmsh-0.1-py3-none-any.whl (16.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page