Chat with LLM in your terminal, be it shell generator, story teller, linux-terminal, etc.
Project description
ShellGPT
Chat with LLM in your terminal, be it shell generator, story teller, linux-terminal, etc.
Install
pip install -U shgpt
This will install two commands: sg
and shgpt
, which are identical.
After install, use sg --init
to create required directories(mainly ~/.shellgpt
).
Usage
ShellGPT has three modes to use:
- Direct mode,
sg [question]
or pipeline likeecho question | sg
. - TUI mode,
sg
, tailored for infer shell command. - REPL mode,
sg -l
, chat with LLM.
See conf.py for configs.
TUI
There are some key bindings to use in TUI: option
ctrl+j
, Infer answerctrl+r
, Run commandctrl+y
, Yank command
Role
There are some built-in roles in shellgpt:
default
, used for ask general questionscode
, used for ask programming questionsshell
, used for infer shell commandcm
, used for generate git commit message, likegit diff | sg -r cm
Users can define their own roles in ~/.shellgpt/roles.json
, it a JSON map with
- key being role name and
- value being role content
Or you can just copy roles.json to play with, it's generated from Awesome ChatGPT Prompts.
$ shgpt -r linux-terminal pwd
/home/user
$ shgpt -r javascript-console 0.1 + 0.2
0.3
Requirements
- Ollama, you need to download models before try shellgpt.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for shgpt-0.3.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 08964f5bf9c728a92ce9344b1f125f3af28bb79a13af652e8a84d34aaed99731 |
|
MD5 | d61d25f10bbb41b713ff8d6f1d97dc33 |
|
BLAKE2b-256 | a8f55a9b008a48a20a0fcb28b4e28c8f80def1ec74fd3c320ba979267b116456 |