Howto

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

Howto 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. Lookup Environment Variables section on how to set up the API key.

Installation

Two-liner

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Guitaricet/howto/main/scripts/get_latest.sh)"
sudo mv howto /usr/local/bin/  # howto.exe on windows

When first calling howto it will ask you to set up the API key. Get your OpenAI API key here.

Download the binary from Github

OS	Architecture	Link
Linux	x86_64	howto-linux-x86_64
MacOS	x86_64 (Intel)	howto-darwin-x86_64
MacOS	arm64 (M1)	howto-darwin-arm64
Windows	x86_64	howto-windows-x86_64

Full list of architectures can be found on the release page.

Then untar it and add it to your PATH. For example:

tar -xvf howto-v2.0.1-darwin-amd64.tar.gz
mv howto /usr/local/bin/

moving the binary to /usr/local/bin can require sudo rights

Build from source

If you have Go installed, you can build the binary from source.

go build

Then move the binary to your path, e.g., mv howto /usr/local/bin/

Disclaimer

Howto suggestions are generated by an AI model and are not guaranteed to be safe to execute or to be executable at all. Please use common sense when using the suggested commands.