Home

Awesome

<h1 align="center"><b> NOTE </b></h1> <h3 align="center"> Instead of using <code>ata</code>, I would advice most people to use <a href="https://github.com/simonw/llm"><code>llm</code></a> by Simon Willison instead. It supports more models and ways to interact with models. </h3> <br> <br> <br> <h1 align="center"><code>ata</code>: Ask the Terminal Anything</h1> <h3 align="center">ChatGPT in the terminal</h3> <p align="center"> <a href="https://asciinema.org/a/565384"><img src="https://asciinema.org/a/565384.svg" alt="asciicast"></a> </p> <h3 align=center> TIP:<br> Run a terminal with this tool in your background and show/hide it with a keypress.<br> This can be done via: Iterm2 (Mac), Guake (Ubuntu), scratchpad (i3/sway), or the quake mode for the Windows Terminal. </h3>

Productivity benefits

Usage

Download the binary for your system from Releases. Or use your package manager to install the application. For example, Brew on MacOS or AUR on Arch Linux have packages available.

To specify the API key and some basic model settings, start the application. It should give an error and the option to create a configuration file called ata.toml for you. Press y and ENTER to create a ata.toml file.

Next, request an API key via https://platform.openai.com/api-keys and update the key in the example configuration file. They key permissions can be "Restricted" to only "Model capabilities".

For more information, see:

$ ata --help

FAQ

How much will I have to pay for the API?

Using OpenAI's API for chat is very cheap. Let's say that an average response is about 500 tokens, so costs about $0.015 (with GPT-4). That means that if you do 50 requests per day, then that will cost you about $0.75 per day ($15 per month assuming you only use it only on workdays). If you use GPT-3.5, then the costs will be much lower.

How does this compare to LLM-based search engines such as You.com or Bing Chat?

At the time of writing, the OpenAI API responds much quicker than the large language model-based search engines and contains no adds. It is particularly useful to quickly look up some things like Unicode symbols, historical facts, or word meanings.

Can I build the binary myself?

Yes, you can clone the repository and build the project via Cargo. Make sure that you have Cargo installed and then run:

$ git clone https://github.com/rikhuijzer/ata.git

$ cd ata/

$ cargo build --release

After this, your binary should be available at target/release/ata (Unix-based) or target/release/ata.exe (Windows).