{"id":13643983,"url":"https://github.com/tychozzz/gpt-web-terminal","last_synced_at":"2025-09-08T11:09:53.840Z","repository":{"id":174236592,"uuid":"651960121","full_name":"tychozzz/gpt-web-terminal","owner":"tychozzz","description":"✨ Open ChatGPT with Programmer's Approach! GPT Terminal is a platform that allows you to communicate with GPT in a terminal.","archived":false,"fork":false,"pushed_at":"2023-08-03T03:56:24.000Z","size":562,"stargazers_count":249,"open_issues_count":1,"forks_count":33,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-09-04T16:06:44.880Z","etag":null,"topics":["chatgpt","cli","command-line","express","gpt","gpt-cli","javascript","nodejs","openai","terminal","typescript","vue3"],"latest_commit_sha":null,"homepage":"https://gpt-terminal.up.railway.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tychozzz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-06-10T16:16:55.000Z","updated_at":"2025-08-07T12:29:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"332c83f8-5db9-4849-993a-a12f0953477f","html_url":"https://github.com/tychozzz/gpt-web-terminal","commit_stats":null,"previous_names":["ltyzzzxxx/gpt-web-terminal","tychozzz/gpt-web-terminal"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/tychozzz/gpt-web-terminal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tychozzz%2Fgpt-web-terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tychozzz%2Fgpt-web-terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tychozzz%2Fgpt-web-terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tychozzz%2Fgpt-web-terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tychozzz","download_url":"https://codeload.github.com/tychozzz/gpt-web-terminal/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tychozzz%2Fgpt-web-terminal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274174271,"owners_count":25235203,"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","status":"online","status_checked_at":"2025-09-08T02:00:09.813Z","response_time":121,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["chatgpt","cli","command-line","express","gpt","gpt-cli","javascript","nodejs","openai","terminal","typescript","vue3"],"created_at":"2024-08-02T01:01:55.804Z","updated_at":"2025-09-08T11:09:53.816Z","avatar_url":"https://github.com/tychozzz.png","language":"TypeScript","funding_links":[],"categories":["CLIs"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://lty-image-bed.oss-cn-shenzhen.aliyuncs.com/blog/GPT.png\" width=\"200\" height=\"200\"\u003e\n\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\n\n\n# GPT Terminal\n\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable-next-line MD036 --\u003e\n_✨ Open GPT like a programmer! Customize your own GPT terminal. ✨_\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/ltyzzzxxx/gpt-web-terminal?display_name=tag\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/ltyzzzxxx/gpt-web-terminal\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/ltyzzzxxx/gpt-web-terminal\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/issues/ltyzzzxxx/gpt-web-terminal\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-Apache%20-yellow.svg\" /\u003e\n\u003c/p\u003e\n\n\n\u003c/div\u003e\n\n[English Doc](./README_EN.md) | [中文文档](./README_CN.md)\n\n## Introduction\n\nGPT Terminal is a platform that allows you to have free conversations with GPT in the terminal.\n\nHere, you can easily implement more customized functionalities and have your own GPT terminal!\n\nThe project is implemented based on Vue3 and Express.\n\n[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template/2S2-Da)\n\n## Preview\n\nDemo Link：https://gpt-terminal.up.railway.app/\n\n![gpt-terminal-demo](https://github.com/ltyzzzxxx/gpt-web-terminal/assets/73587471/dee28750-b86b-45a1-a8b2-8357b3e27a25)\n\n## Features\n\n- ✨ Support dialogue between command-line terminal and GPT. As programmers, we communicate with GPT in a geeky way!\n\n- 🌟 Support configuration of API Key (OpenAI API method) and Access Token (Web API method) - either one can be chosen.\n\n- 🌈 Support DIY of GPT roles and persist them. Have conversations with your exclusive role!\n\n- ☁️ Support GPT to remember the conversation history and provide commands to query the history. Give your GPT a good memory~\n\n- 🍀 Support the widely-used Event Stream technology for GPT responses, achieving a typewriter effect~\n\n- 🌴 Support rendering GPT responses in Markdown format.\n\n- 🍃 Basic terminal commands such as viewing command history, accessing help manuals, clearing the screen, etc.\n\n## Quick Start\n\nYou only need to have a basic understanding of using `npm` to unlock all the features!\n\n1.   Clone the project to your local machine.\n\n     ```bash\n     git clone https://github.com/ltyzzzxxx/gpt-web-terminal.git\n     ```\n\n2.   Navigate to the project directory and install dependencies for the frontend and backend separately.\n\n     ```bash\n     cd gpt-web-terminal \u0026\u0026 npm install\n     cd service \u0026\u0026 npm install\n     ```\n\n3.   Configure your API Key or Access Token in `service/.env`. API key takes priority.\n\n      ```\n      # Choose either API Key (OpenAI API method) or Access Token (Web API method)\n      OPENAI_API_KEY=\n      OPENAI_ACCESS_TOKEN=\n      # Configure reverse proxy address when using Access Token\n      API_REVERSE_PROXY=\n      ```\n\n4.   Run the frontend.\n\n     ```bash\n     npm run dev\n     ```\n\n5.   Run the backend.\n\n     ```bash\n     npm run start\n     ```\n\n6.  Quickly unlock command usage - use the help command in the command-line to query the usage.\n\n    ```bash\n    # Query all command help\n    help\n\n    # Query specific command help\n    gpt -h\n    gpt chat -h\n    gpt role -h\n    gpt history -h\n    ```\n \n## How to Design Your Own GPT Role?\n   \nUse the following command to start the role `DIY` process\n\n```bash\n# k - Role unique identifier, e.g., default / cli / sql / ikun\n# n - Role name, e.g., Command-line Translation Assistant, SQL-BOY\n# d - Role description, e.g., Translate your natural language instructions into Windows/Unix terminal commands\ngpt diy \u003c-k GPT role unique identifier\u003e \u003c-n GPT role name\u003e \u003c-d GPT role description\u003e\n```\n\n## Special Thanks\n\nThis project was inspired by [YuIndex](https://github.com/liyupi/yuindex)，and eventually transformed it into \"GPT Terminal\".\n\n- [@程序员鱼皮](https://github.com/liyupi)\n- [@MagicCube](https://github.com/MagicCube)\n- [@Overtrue](https://github.com/Overtrue)\n\n\n## Open Source License\n\nApache License Version 2.0 see http://www.apache.org/licenses/LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftychozzz%2Fgpt-web-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftychozzz%2Fgpt-web-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftychozzz%2Fgpt-web-terminal/lists"}