Skip to content

code-yeongyu/YGK-a

Repository files navigation

YGKA 🤖

codecov Release Package to PyPI PyPI version

YGKA is an advanced ChatGPT client for shell that acts as Your Genius Knowledgeable Assistant. YGKA supports Unix/Linux pipelines and requires no setting up of tokens or API keys. Furthermore, if you want to use an OpenAI API key, you can easily configure it.

demo

Key Features 💡

  • Supports Unix/Linux pipelines
  • Ready to use without setting up tokens or API keys

Prerequisites 📚

  • Python 3.9+
  • ChatGPT Account (or OpenAI Account)

Getting Started 🚀

To begin using YGKA, install it with pip:

pip install ygka

Once you've installed YGKA, you can start using it right away, like following.

demo

To execute a command, use the following syntax:

ygka "<your command here>"

For example, to ask "hello?" using YGKA, you can use the following command:

ygka "hello?"

You can also use YGKA with Unix pipeline. For example, to ask "what is this file?" while viewing the contents of a text file, you can use the following command:

cat textfile.txt | ygka "what is this file?"

Advanced Settings 🛠

By default, YGKA is configured to use the reverse-engineered ChatGPT client and retrieve login information from your browser, so you don't need to configure anything to use YGKA. However, for those who want to use different models with an OpenAI API Key, you can configure it as follows:

  1. Create an account on OpenAI.
  2. Go to https://platform.openai.com/account/api-keys and copy your API key.
  3. Modify or create the ~/.ygka_config.json file as follows:
{
    ...
    "language_model": <language model of your preference>, //"official_chatgpt"
    "openai_api_key": <your OpenAI API key>
}

Here, you can specify the language model of your preference and add your OpenAI API key.

Inspired By 🎨

  • YeonGyu Kim: My name. The project is named after me.
  • AiShell: A Natural Language Shell Powered by ChatGPT, is a brother project of YGKA that provides a similar functionality.
  • loz: A nodejs version of a GPT3 client that does similar things as YGKA.

Contributions 💬

Feel free to contribute to YGKA by adding more functionality or fixing bugs.