A textual user interface for

Prerequisites (❗Read carefully❗)

Firstly, you’ll need to install the package

pip install google-tui

Secondly, you’ll need to get google search api key(s)

  1. Go to
  2. Scroll down
  3. Click the big blue Get a key button (screenshot])
  4. Make a app if you haven’t already, the name doesn’t matter
  5. Click the NEXT button
  6. You’ll get an api key

You can do the above process as many times as you want. Each api key has a 100 request limit per day, which is plenty for normal use but if you ever run out of uses you can just create more api keys

Thirdly, you’ll need to provide the token(s) to the package. You can use a environment variable named GOOGLE_API_KEY or you can pass the token(s) directly with the --token/-t flag. The environment variable/flag value should be comma separated without spaces (e.g. a,b,c) for multiple tokens or just a singe token (a).

Then you can go in a terminal and run


And that should work, otherwise try

python -m google_tui


View Github