Skip to content

YGK-a: Your Genius, Knowledgeable assistant, An advanced ChatGPT client from your shell.

License

Notifications You must be signed in to change notification settings

code-yeongyu/YGK-a

Folders and files

NameName
Last commit message
Last commit date
Mar 13, 2023
Mar 5, 2023
Mar 5, 2023
Mar 5, 2023
Apr 15, 2023
Mar 5, 2023
Mar 5, 2023
Mar 6, 2023
Apr 15, 2023
Apr 15, 2023
Mar 5, 2023
Apr 15, 2023
Apr 15, 2023

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.