Howto is a GPT-3/Codex-powered shell tool that allows you to talk with your shell in natural language.
Forgot how to create a conda environment?
% howto create conda env
conda create -n <env_name> python=3.6
Forgot how to add a new env to Jupyter?
% howto add kernel to jupyter
python -m ipykernel install --user --name=
Want to download the biggest Rick Astley's hit?
% howto download youtube video for never give you up
youtube-dl -f 18 https://www.youtube.com/watch?v=dQw4w9WgXcQ
It can also suggest how to be a nicer person
% howto be a nicer person
alias please='sudo'
It works by sending requests to OpenAI API and requires you to setup your own OPENAI_API_TOKEN
.
Download the binary from the releases page.
Then move the binary to your path, e.g., mv howto /usr/local/bin/
If you have Go installed, you can build the binary from source.
go build
if you have your
$GOPATH/bin
in your path, just rungo install .
to install the binary
Then move the binary to your path, e.g., mv howto /usr/local/bin/
You need to connect your OpenAI API key to the program by setting the OPENAI_API_KEY
environment variable. Get your OpenAI API key here.
OPENAI_API_KEY=<your_api_key>
By default we use text-davinci-002
, you can change it to a different model by setting the HOWTO_OPENAI_MODEL
environment variable. It's best to use Codex models (e.g., code-davinci-002
), but they are currently in beta and not available to everyone.
HOWTO_OPENAI_MODEL=code-davinci-002