please: Ask your computer nicelyplease is a command-line tool that accepts natural language
input, then uses an LLM to generate + run a Bash script.
View on Github here.
pip install git+https://github.com/aniiyengar/please.git
NOTE: You need to pass your OpenAI API key in your environment as
OPENAI_API_KEY.
Type your prompt in natural language starting with the word "please".
$ please <prompt>
For example:
$ please create a standard gitignore for a python package in the current directory
echo "# Byte-compiled / optimized / DLL files" >> .gitignore
echo "__pycache__/" >> .gitignore
echo "*.py[cod]" >> .gitignore
echo "*$py.class" >> .gitignore
echo "*.so" >> .gitignore
echo "*.egg-info/" >> .gitignore
echo "dist/" >> .gitignore
echo "build/" >> .gitignore
echo "pip-wheel-metadata/" >> .gitignore
echo "*.egg" >> .gitignore
echo "*.egg-info" >> .gitignore
echo ".eggs/" >> .gitignore
Creating a .gitignore file and adding rules to ignore various types of files and directories.
If a script fails, please pipes stderr back into the LLM
to create a revised script. This is especially useful when a file
or dependency doesn't exist, etc.
If the prompt isn't specific enough, please prompts the user for
extra information, which gets inserted into the script before it's run.
please will print the command(s) being executed, and summarizes
the command(s) of the script in natural language after execution.
Some capabilities are shown in this Twitter thread.
I'm open-sourcing this in the interest of collaboration and openness, but I don't plan on maintaining it a lot. There are a few improvements that can be made though: