From 76bbc35d4a9cfae4af6f13572a527b9b94036860 Mon Sep 17 00:00:00 2001 From: Jun Nishimura Date: Wed, 30 Aug 2023 01:43:05 +0900 Subject: [PATCH] Create README.md --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..8bc360a --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +

+ ♫ Chatify ♫
Chat-based music recommendation tool +

+ +

+ GitHub release (latest by date) + GitHub + Go Report Card +

+ +## 📖 Overview +Chatify is a TUI(Terminal User Interface) tool that combines the OpenAI API with the Spotify API, allowing an AI bot to recommend the music you are looking for through conversation. + +## ⚠️ Notice +Unfortunately, Chatify is currently not free to use; you need to have a Spotify Premium account and pay to use the OpenAI API. + +## 👜 Prerequisites +Chatify requires two things. +1. You need to have [a Spotify Premium Account](https://www.spotify.com/premium/) to use Spotify API. +2. You need to have [a OpenAI account](https://platform.openai.com/login) to use OpenAI API. + +## 💻 How to use +### 1. Install +#### Homebrew Tap +``` +brew install JunNishimura/tap/Chatify +``` +#### Go install +``` +go install github.com/JunNishimura/Chatify@latest +``` + +### 2. Preparation +Before saying hi to Chatify, please prepare the following three items. + +1. Spotify App Client ID +2. Spotify App Client Secret +3. OpenAI API key + +As for `Spotify App Client ID` and `Spotify App Client Secret`, please create any app from the [Spotify for Developers Dashboard](https://developer.spotify.com/dashboard) and retrieve them from the settings screen. + +For `OpenAI API key`, please create an API key from [the OpenAI account screen](https://platform.openai.com/account/api-keys) and obtain it. + +### 3. Greetings to Chatify +You need to provide a couple of information to Chatify at first. + +``` +$ chatify greeting +``` + +### 3. Talk with Chatify +Let's talk to Chatify and embark on a journey to discover new music! + +``` +$ chatify hey +``` + +## 🪧 License +Chatify is released under MIT License. See [MIT](https://raw.githubusercontent.com/JunNishimura/Chatify/main/LICENSE)