icon

GPT Runner

English / [็ฎ€ไฝ“ไธญๆ–‡ ๐ŸŒ](https://github.com/nicepkg/gpt-runner/tree/main/README_CN.md) Use GPT-Runner to manage your AI presets, engage in AI-powered conversations with your code, and significantly boost the development efficiency of both you and your team! ็”จ GPT-Runner ็ฎก็†ๆ‚จ็š„ AI ้ข„่ฎพ๏ผŒ้€š่ฟ‡ AI ไธŽๆ‚จ็š„ไปฃ็ ๆ–‡ไปถ่Šๅคฉ๏ผŒๆžๅคงๆๅ‡ๆ‚จๅ’Œๅ›ข้˜Ÿ็š„ๅผ€ๅ‘ๆ•ˆ็އ๏ผ [![CLI][cli-image]][cli-url] [![Web][web-image]][web-url] [![VSCode][vscode-image]][vscode-url] [![License](https://img.shields.io/github/license/nicepkg/gpt-runner)][gpt-runner-license] [![GitHub stars](https://img.shields.io/github/stars/nicepkg/gpt-runner?style=social)][gpt-runner-url] [CLI](https://github.com/nicepkg/gpt-runner/tree/main/packages/gpt-runner-cli/) / [Web Page](https://github.com/nicepkg/gpt-runner/tree/main/packages/gpt-runner-web/) / [VSCode Extension](https://github.com/nicepkg/gpt-runner/tree/main/packages/gpt-runner-vscode/) / [Issues](https://github.com/nicepkg/gpt-runner/issues) / [Buy Me a Coffee](https://bmc.link/jinmingyang) [็ปˆ็ซฏๅทฅๅ…ท](https://github.com/nicepkg/gpt-runner/blob/main/packages/gpt-runner-cli/README_CN.md) / [็ฝ‘้กต็‰ˆ](https://github.com/nicepkg/gpt-runner/tree/main/packages/gpt-runner-web/) / [VSCode ๆ‰ฉๅฑ•](https://github.com/nicepkg/gpt-runner/blob/main/packages/gpt-runner-vscode/README_CN.md) / [ๅ้ฆˆ](https://github.com/nicepkg/gpt-runner/issues) / [ๆ‰“่ตๅผ€ๅ‘่€…](https://user-images.githubusercontent.com/35005637/255805279-da299e44-ab7a-4038-b945-86d33128a775.jpg) [cli-url]: https://github.com/nicepkg/gpt-runner/tree/main/packages/gpt-runner-cli/ [cli-image]: https://img.shields.io/badge/CLI-Node.js-green?logo=node.js [gpt-runner-license]: https://github.com/nicepkg/gpt-runner/tree/main/LICENSE [gpt-runner-url]: https://github.com/nicepkg/gpt-runner [web-url]: https://github.com/nicepkg/gpt-runner/tree/main/packages/gpt-runner-web/ [web-image]: https://img.shields.io/badge/Web-React-blue?logo=react [vscode-url]: https://github.com/nicepkg/gpt-runner/tree/main/packages/gpt-runner-vscode/ [vscode-image]: https://img.shields.io/badge/VSCode-Extension-blue?logo=visualstudiocode
https://user-images.githubusercontent.com/35005637/252378643-f0d053ac-88db-4b92-966a-75a411a1ce6c.mp4
๐Ÿ“š Table of Contents
- [๐Ÿคทโ€โ™‚๏ธ Why GPT-Runner?](#๏ธ-why-gpt-runner) - [โš™๏ธ Features](#๏ธ-features) - [๐Ÿš€ Quick Start](#-quick-start) - [The first way: CLI](#the-first-way-cli) - [The second way: VSCode Extension](#the-second-way--vscode-extension) - [๐Ÿ“– Documentation](#-documentation) - [GPT-Runner Configs And AI Preset Files](#gpt-runner-configs-and-ai-preset-files) - [GPT-Runner Ui Usage](#gpt-runner-ui-usage) - [๐Ÿ—’๏ธ Road map](#๏ธ-road-map) - [๐Ÿ†• What's New](#-whats-new) - [โ“ FAQ](#-faq) - [๐Ÿ’– Sponsor](#-sponsor) - [๐Ÿค Contributor](#-contributor) - [๐Ÿ™ Acknowledgement](#-acknowledgement) - [๐Ÿ“œ LICENSE](#-license)
## ๐Ÿคทโ€โ™‚๏ธ Why GPT-Runner? 1. **๐Ÿ” Conversations with Code Files:** - Before using GPT-Runner: Manual copy and paste of multiple file codes into the ChatGPT window were required to propose features or fix bugs to AI.๐Ÿ™ - After using GPT-Runner: Simply select your project files from the file tree. The AI will provide responses based on the most recent contents of those files.๐Ÿคฉ 2. **๐Ÿ“‘ Manage the Project's AI Presets:** - Before using GPT-Runner: Project prompts saved in memos needed to be copied and pasted to ChatGPT for inquiries, making it difficult to put them under git version control.๐Ÿคช - After using GPT-Runner: Each [xxx.gpt.md](https://github.com/nicepkg/gpt-runner/tree/main/docs/examples/example-en.gpt.md) file represents an AI role preset. They are easy to read, modify, and can be version-controlled. Team members can share and enhance AI presets, making the code they produce closer to 100% usability.๐Ÿฅฐ ## โš™๏ธ Features - **๐Ÿ” Conversations with Code Files**: Select files or folders and engage in real-time conversations with AI. - **๐Ÿ› ๏ธ Powerful CLI and IDE integration:** Implement efficient AI workflows in various IDEs. - **๐Ÿ”– AI Preset Manager:** Manage your AI presets, Just like a locally Storybook for AI presets. - **๐Ÿค– Customize AI parameters:** Flexibly control the configuration of AI models. - **๐Ÿ”Œ Support for third-party LLMs:** High compatibility and adaptability. - **๐Ÿ”’ Privacy-first:** Local data storage protects your privacy. - **๐ŸŒŽ Locale support:** Support for multiple languages. ## ๐Ÿš€ Quick Start > Make sure you have an Open AI Key or a Anthropic Key. You can get it from [Open AI](https://platform.openai.com/account/api-keys) or [Anthropic](https://www.anthropic.com/). ### The first way: CLI > 1. Requirements NodeJS >= 16.15.0 > - To check your NodeJS version, run `node -v` in your terminal. If you need to install or update NodeJS, visit [the official NodeJS website](https://nodejs.org/) for download and installation instructions. > 2. First run the following command to download this package, which will take a long time, which is normal. ```bash cd npx gptr ``` You can see the web interface in your browser at [http://localhost:3003](http://localhost:3003). ### The second way: VSCode Extension > Requirements VSCode >= 1.78.0 Install the [GPT-Runner VSCode Extension](https://marketplace.visualstudio.com/items?itemName=nicepkg.gpt-runner) from the VSCode Marketplace. ## ๐Ÿ“– Documentation ### GPT-Runner Configs And AI Preset Files For details about `gptr.config.json` configuration file, `xxx.gpt.md` AI preset file, `.gpt-runner` special directory, please refer to here: [Introduction to GPT-Runner Configs And AI Preset Files](https://github.com/nicepkg/gpt-runner/blob/main/docs/gpt-config.en.md) ### GPT-Runner Ui Usage [Introduction to GPT-Runner Ui Usage](https://github.com/nicepkg/gpt-runner/blob/main/docs/ui-usage.en.md) ## ๐Ÿ—’๏ธ Road map - [ ] Jetbrains Plugin: Add Jetbrains IDE Plugin - [ ] Export And Import Chat History: Add dialogue import and export function - [ ] AI Preset Store: Add AI Preset Store for community sharing AI Preset File - [ ] Template Interpolation: Add template interpolation support - [ ] Electron: Add an Electron client to expand the target audience to non-developers ## ๐Ÿ†• What's New - ๐Ÿš€ v1.0.0: First Release ## โ“ FAQ > You can contact me via [2214962083@qq.com](mailto:2214962083@qq.com) > > ๅฏน AI ๆๅ‡ๅผ€ๅ‘ๆ•ˆ็އๆ„Ÿๅ…ด่ถฃ็š„๏ผŒๅฏไปฅๅŠ ๆˆ‘ wechat: qq2214962083 ๅ…ฅ็พคไบคๆต > > ่ฆๆฑ‚๏ผšไผš็ง‘ๅญฆไธŠ็ฝ‘๏ผŒไฝฟ็”จ่ฟ‡ chatgpt [English > FAQ](https://github.com/nicepkg/gpt-runner/tree/main/docs/faq.en.md) ## ๐Ÿ’– Sponsor Waiting for you... ## ๐Ÿค Contributor You can check out our [Contribution Guidelines](https://github.com/nicepkg/gpt-runner/tree/main/CONTRIBUTING.md) This project exists thanks to all the people who contribute: ## ๐Ÿ™ Acknowledgement GPT-Runner is made possible thanks to the inspirations from the following projects: > in alphabet order - [Docusaurus](https://github.com/facebook/docusaurus) - [Gradio](https://github.com/gradio-app/gradio) - [LangchainJs](https://github.com/hwchase17/langchainjs) - [Monaco-React](https://github.com/suren-atoyan/monaco-react) - [UnoCss](https://github.com/unocss/unocss) - [VSCode-Material-Icon-Theme](https://github.com/PKief/vscode-material-icon-theme) - [VSCode-Webview-Ui-Toolkit](https://github.com/microsoft/vscode-webview-ui-toolkit) ## ๐Ÿ“œ LICENSE [MIT](https://github.com/nicepkg/gpt-runner/tree/main/LICENSE) License © 2023-PRESENT [Jinming Yang](https://github.com/2214962083)