Skip to content

Quickly generate plots in Python by simply describing them through text - e.g. use "create a scatter plot with name labels" instead of endlessly searching stackoverflow.

License

rdnfn/autoplotlib

Repository files navigation

PyPI version

Quickly generate plots in Python by simply describing them through text. For example, simply use the prompt "create a scatter plot with name labels" instead of endlessly searching the docs and stackoverflow. Given such a prompt, the autoplotlib Python library uses the OpenAI API to automatically generate the corresponding code and plot - saving you time and effort.

Warning This package is experimental. The package can execute code output from language models. Albeit unlikely, always check and confirm no malicious code was generated by the model before execution. Use at your own risk.

Installation

  1. Install the Python package:
    pip install autoplotlib
    
  2. Get an OpenAI API key by signing up here if you don't have one already.

Usage

The following is an example of plotting a pandas dataframe using the autoplotlib library. The plot() function takes a prompt describing the plot and the data to plot. The function returns the plot, the generated code, and the full response from the OpenAI API.

# set the OpenAI API key
import os
os.environ["OPENAI_API_KEY"] = "<YOUR_API_KEY>"

import autoplotlib as aplt
import pandas as pd

data = pd.DataFrame(
    [[29, 177], [33, 186], [48, 161], [53, 173], [67, 152]],
    index=["Alice", "Bob", "Charlie", "Dave", "Eve"],
    columns=["age", "height"],
)

figure_description = """
Plot the data as scatterplot between height and age.
Add the names as labels next to the data points.
Ensure the labels don't overlap.
Mark people taller than 170 with a star instead of a point.
"""

code, fig, llm_response = aplt.plot(figure_description, data=data)

Contributing

See the development guide for information about contributing.

Potential future features

  • Add sandboxing of code execution (see here)

License

MIT License

About

Quickly generate plots in Python by simply describing them through text - e.g. use "create a scatter plot with name labels" instead of endlessly searching stackoverflow.

Topics

Resources

License

Stars

Watchers

Forks