https://github.com/tidyverse/ggbot2
https://github.com/tidyverse/ggbot2
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/tidyverse/ggbot2
- Owner: tidyverse
- License: other
- Created: 2025-09-19T17:47:08.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-09-19T19:56:25.000Z (4 months ago)
- Last Synced: 2025-09-19T22:03:26.861Z (4 months ago)
- Language: R
- Size: 15.6 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ggbot2
[](https://lifecycle.r-lib.org/articles/stages.html#experimental)
ggbot2 is a voice assistant for ggplot2. It helps you create and customize ggplot2 visualizations using voice commands.
## Prerequisites
In order to use ggbot, you will need an OpenAI API key. You can obtain one from the [OpenAI dashboard](https://platform.openai.com/api-keys). You'll also need to put at least a few dollars on your account to use the API.
Once you have an API key, you will need to set it as an environment variable named `OPENAI_API_KEY`. You can do this by adding the following line to an `.Renviron` file in your project directory:
```
OPENAI_API_KEY=your_api_key_here
```
Then restart your R session.
## Installation
```r
pak::pak("tidyverse/ggbot2")
```
## Usage
To launch ggbot, simply call the `ggbot()` function, passing in the name of a data frame variable:
```r
ggbot2::ggbot(mtcars)
```
## Act natural
There's no need to speak clearly, slowly, or formally to ggbot. Try speaking like you would to a person sitting across from you.
You don't ever have to wait for ggbot to finish talking; you can just start speaking and ggbot will quickly notice you are interrupting.
You don't have to be precise with your commands to ggbot. For example, give it a general sense of what you're trying to convey with your visualization. Or tell it what you don't like about the current version.
## Suggested prompts
Here are the kinds of things you can say to ggbot:
- "Create a scatter plot of mpg vs weight"
- "Color by cylinder"
- "Make the points blue and larger"
- "Add a title to the plot"
- "There are too many x-axis labels"
- "Add an annotation that calls out the year 2020"
- "Make the plot look less busy"
- "Let's go back to the last version"