{"id":21167759,"url":"https://github.com/nicolodiamante/zchat","last_synced_at":"2025-05-07T09:43:34.451Z","repository":{"id":171053692,"uuid":"646757777","full_name":"nicolodiamante/zchat","owner":"nicolodiamante","description":"Elevate your Terminal's efficiency: harness the unbeatable auto-complete power through seamless ChatGPT integration!","archived":false,"fork":false,"pushed_at":"2024-02-17T08:25:19.000Z","size":52,"stargazers_count":16,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T08:44:06.109Z","etag":null,"topics":["ai","auto-complete","auto-completion","chat-completion","chatgpt","command-line","copilot-chat","ohmyzsh","ohmyzsh-customize","ohmyzsh-plugin","openai","openai-api","openai-chatgpt","terminal","terminal-ai","terminal-chatgpt","zsh","zsh-plugin"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicolodiamante.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-29T09:19:02.000Z","updated_at":"2025-01-17T23:30:28.000Z","dependencies_parsed_at":"2024-01-21T18:23:01.006Z","dependency_job_id":"2da3a7c8-d93f-4cc4-91e0-500f93ef3a3f","html_url":"https://github.com/nicolodiamante/zchat","commit_stats":null,"previous_names":["nicolodiamante/zchat"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Fzchat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Fzchat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Fzchat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Fzchat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicolodiamante","download_url":"https://codeload.github.com/nicolodiamante/zchat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252852800,"owners_count":21814412,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","auto-complete","auto-completion","chat-completion","chatgpt","command-line","copilot-chat","ohmyzsh","ohmyzsh-customize","ohmyzsh-plugin","openai","openai-api","openai-chatgpt","terminal","terminal-ai","terminal-chatgpt","zsh","zsh-plugin"],"created_at":"2024-11-20T15:01:55.138Z","updated_at":"2025-05-07T09:43:34.431Z","avatar_url":"https://github.com/nicolodiamante.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nicolodiamante/zchat/assets/48920263/2eae1d23-a5b0-484c-ba57-ea30a821545d\" draggable=\"false\" ondragstart=\"return false;\" alt=\"Zchat\" title=\"Zchat\" /\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/zchat/assets/48920263/42de772d-6457-47bd-b5b7-fc5b624e56ef\" draggable=\"false\" ondragstart=\"return false; \"alt=\"Zchat\" title=\"Zchat\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\nBoost your productivity and enhance your terminal experience using Zchat (zch). This command-line productivity tool is powered by OpenAI's ChatGPT models. With Zchat, you don't need to scour the web for Linux commands and code snippets. Simply type in comprehensive language queries and let the system generate the results for you. Zchat's AI capabilities provide precise responses directly in your terminal, saving your time and effort. Additionally, Zchat's intuitive Git integration simplifies your version control processes – bidding farewell to cheat sheets and notes. With Zchat, complete tasks quickly and conveniently.\n\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/zchat/assets/48920263/d39a5df5-3864-4314-b4c6-9bb944233634\" draggable=\"false\" ondragstart=\"return false; \"alt=\"ChatGPt conbined with the Terminal\" title=\"ChatGPt conbined with the Terminal\" width=\"700px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n## Create your OpenAI API Key\n\nTo utilise Zchat, you initially need to procure the API key. You can generate this key from your OpenAI account, which will subsequently be used for authentication. Here's how to get your API key:\n\n1. Sign in to your [OpenAI account][open-ai-account].\n2. Search for the \"Create new secret key\" option and select it.\n\nThis API key serves as your passport to access and engage with Zchat.\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/zchat/assets/48920263/3ae7efce-01ad-4069-80bf-7a8dec2dc3b1\" draggable=\"false\" ondragstart=\"return false; \"alt=\"IMG show how to create new secret key\" title=\"Create new secret key\" width=\"750px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\nOnce you have obtained your [API Key][open-ai-API], integrating ChatGPT's services with Zchat is straightforward. Note that once you have copied the API Key and closed the pop-up window, you will no longer be able to access and view the key, making it essential that you store it in a secure and safe place.\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/zchat/assets/48920263/8db385ed-d310-4fb0-a8a5-5dc3514ca357\" draggable=\"false\" ondragstart=\"return false; \"alt=\"IMG show an example of a OpenAI API Key\" title=\"OpenAI API Key\" width=\"750px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n## Getting Started\n\nHere are the two methods you can choose from:\n\n**Automatic Download via `curl`:** Simply execute the following command in your terminal to quickly download and seamlessly install the utility:\n\n```shell\nzsh -c \"$(curl -fsSL https://raw.githubusercontent.com/nicolodiamante/zchat/HEAD/bootstrap.zsh)\"\n```\n\n**Manual Cloning:** For those who prefer a hands-on approach, you can manually clone the repository:\n\n```shell\ngit clone https://github.com/nicolodiamante/zchat.git ~/zchat\n```\n\n\u003cbr\u003e\n\n### Post-Download Steps\n\n**Directory Navigation \u0026 Script Execution:** Navigate to the root directory of the repository, and then execute the installation script using the following command:\n\n```shell\nsource utils/install.zsh\n```\n\n**Zchat Configuration:** This script aims to locate the `zshrc` file, then appends the path `zchat/script` to the `fpath` variable, and sets the `OPENAI_API_KEY` variable.\n\n```shell\n# Zchat path.\nfpath=(~/zchat/script $fpath)\nautoload -Uz zchat\n```\n\n\u003cbr\u003e\n\n### Install via [Oh My Zsh][ohmyzsh]\n\n```shell\ngit clone https://github.com/nicolodiamante/zchat.git $ZSH_CUSTOM/plugins/zchat\n```\n\n- Add to your zshrc plugins array `plugins=(... zchat)`\n- Paste your API Key at the `OPENAI_API_KEY` variable in your zshrc.\n- Restart the shell to activate.\n  \u003cbr\u003e\u003cbr\u003e\n\n### Setting up dependencies\n\nAfter completing the installation process, configuration of the Zchat application is required. This step involves inserting the OpenAI API Key into the OPENAI_API_KEY variable located in the .zshrc file. By default, the script uses the GPT-4 Turbo model. However, access to GPT-4 APIs, including both GPT-4 and GPT-4 Turbo, may be limited and generally requires a proven history of successful transactions with OpenAI. If the necessary criteria for accessing GPT-4 or GPT-4 Turbo are not met, or if an alternative model is desired, the script can be adapted to utilise other models, such as GPT-3.5-Turbo. In instances where neither GPT-4 Turbo nor GPT-4 is accessible, opting for GPT-3.5-Turbo is advised.\n\n```shell\n# Zchat dependencies.\nexport OPENAI_API_KEY=\n```\n\n\u003e For Zchat to function properly, jq must be installed on your operating system. The script will automatically check for this software. If it isn't detected, the script will proceed with the necessary installation.\n\n\u003cbr\u003e\n\n## How to use Zchat\n\n```shell\nzch \u003cdescription of task\u003e\n```\n\n### Completion\n\n1. To initiate the completion, simply type 'zch' followed by the command that you want to use for your query.\n2. After formulating your query in natural language, press the 'Enter' key to execute it.\n\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nicolodiamante/zchat/assets/48920263/0a2f6192-5000-4b35-a063-dd7952b22084\" draggable=\"false\" ondragstart=\"return false;\" alt=\"Zchat Completion\" title=\"Zchat Completion\" /\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/zchat/assets/48920263/7d4091d1-fec2-4cd9-ba9b-36ed2f207e1a\" draggable=\"false\" ondragstart=\"return false; \"alt=\"Zchat Completion\" title=\"Zchat Completion\" width=\"650px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\u003cbr\u003e\n\n## Notes\n\nUpon launching Zchat, the script automatically checks whether you're in a Git repository. If it determines that you are, Zchat will present relevant Git commands and provide guidance. If you're not in a Git repository, Zchat assists you in accessing the appropriate command line tools to find the most effective solution for your task.\n\n### Resources\n\n#### OpenAI\n\n- [OpenAI Documentation][intro]\n- [OpenAI Models][open-ai-models]\n- [OpenAI Chat][chat-completions]\n\n#### Zsh Documentations\n\n- [Documentation Index][zsh-docs]\n- [User Guide][zsh-docs-guide]\n\n### Contribution\n\nThank you for considering using Zchat. Any suggestions or feedback you may have for improvement are welcome. If you encounter any issues or bugs, please report them on the [issues page][issues].\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/zchat/assets/48920263/977f7ef6-11c9-495f-8b66-1b0c762d95c6\" draggable=\"false\" ondragstart=\"return false;\" /\u003e\u003c/\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://nicolodiamante.com\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/zchat/assets/48920263/a2d53e2d-ed83-483d-b27a-4c1f04c15061\" draggable=\"false\" ondragstart=\"return false;\" alt=\"Nicol\u0026#242; Diamante Portfolio\" title=\"Nicol\u0026#242; Diamante\" width=\"17px\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nicolodiamante/zchat/assets/48920263/cb5d36f0-ccad-4fee-9dd4-e2f895ab225c\" draggable=\"false\" ondragstart=\"return false;\" alt=\"MIT License\" title=\"MIT License\" /\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/zchat/assets/48920263/b9e78453-f608-42fa-8440-9ed0118bb354\" draggable=\"false\" ondragstart=\"return false; \"alt=\"MIT License\" title=\"MIT License\" width=\"95px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003c!-- Link labels: --\u003e\n\n[open-ai-account]: https://chat.openai.com/auth/login\n[open-ai-API]: https://beta.openai.com/account/api-keys\n[open-ai-models]: https://platform.openai.com/docs/models\n[intro]: https://platform.openai.com/docs/introduction\n[chat-completions]: https://platform.openai.com/docs/guides/chat\n[ohmyzsh]: https://github.com/robbyrussell/oh-my-zsh/\n[zsh-docs]: http://zsh.sourceforge.net/Doc\n[zsh-docs-guide]: http://zsh.sourceforge.net/Guide/zshguide.html\n[issues]: https://github.com/nicolodiamante/zchat/issues\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicolodiamante%2Fzchat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicolodiamante%2Fzchat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicolodiamante%2Fzchat/lists"}