Skip to main content

pynarrator

Template-based NLG framework for creating text narratives out of data

Installation

You can install the package from pip:

pip3 install pynarrator
import os
from pynarrator import narrate_descriptive, read_data

Basic Usage

pynarrator has a range of functions for creating template-based narratives and also embedded data set that you can use by calling read_data(). Function downloads raw data from github, if you get a SSL error when running it, please run this first:

import ssl
ssl._create_default_https_context = ssl._create_unverified_context
sales = read_data()
narrative = narrate_descriptive(sales, measure = 'Sales', dimensions = ['Region', 'Product'], coverage = 0.5)

{'Total Sales': 'Total Sales across all Regions is 38790478.42.', 'Region by Sales': 'Outlying Regions by Sales are NA (18079736.4, 47.0%), EMEA (13555412.7, 35.0%).', 'Product by Sales': 'Outlying Products by Sales are Food & Beverage (15543469.7, 40.0%), Electronics (8608962.8, 22.0%).'}

Chat GPT

In order to use ChatGPT in pynarrator, you must specify your OpenAI API token as OPENAI_API_KEY environment variable:

os.environ['OPENAI_API_KEY'] = 'xx-xxxxxxxxxx'
 from pynarrator import gpt_get_completions, enhance_narrative, translate_narrative, summarize_narrative

Improve the narrative text to make it rich with business language

enhance_narrative(narrative)
enhance_narrative(narrative, language = 'Spanish')
summarize_narrative(narrative)

Complete documentation is available at the narrator package website

Metadata

Release files for pynarrator 0.0.1.15

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for pynarrator 0.0.1.15
File Interpreter ABI Platform
pynarrator-0.0.1.15-py3-none-any.whl Python 3 none any Details

Release files / pynarrator-0.0.1.15-py3-none-any.whl

Download URL pynarrator-0.0.1.15-py3-none-any.whl
Size 23.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
937b9b437a0a4244657fe81dba7a6b96d8541855819cacf1c1533105464e0b70
BLAKE2b-256 checksum
How to use checksums
050faedc06a300013c7db4e28ef7c7bac36b115671589d19ae9ce703dfabff6e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.6

Release history Release notifications | RSS feed

This release

0.0.1.15 This release

1 release file

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page