Skip to main content

Query Discourse and summarize threads

Project description

discuss-nutshell

Actions Status Documentation Status PyPI version Conda-Forge PyPI platforms GitHub Discussion

Improve your understanding of long Discourse threads.

Problem statement

Discourse topics, such as on discuss.python.org, can get very long even over a few hours or days. These long threads makes it difficult to understand the conversation without spending one to three hours reading the thread. Discourse gives a predicted time to read the thread.

On discuss.python.org, discussion threads about an individual [Python Enhancement Proposal](https://peps.python.org], PEP, can get very long. To understand the pros and cons of the PEP, reading the thread is needed.

Motivation

I want a time-efficient way to read posts and summarize the key points. Ideally, I would like to understand the pros and cons of an individual PEPs. Understanding the authors' motivations and their background also is important.

Recapping the conversation in an accurate way would be very helpful.

Initial approach

Take a Discourse topic and parse it into posts that can be queried.

  • data_loader.py: Hit an endpoint and save to json
  • preprocessor.py: Do data cleaning and parsing into individual post files
  • launch_app.py: Launch gradio app to interact with the LLM and log queries, context, responses

Take the db file and use datasette to view: datasette data/posts_qa_logs.db

Summarize individual posts and aggregate the summarized posts into one posts file that can be queried.

Use a simple Gradio UI to interface with the user.

Next phases

Data to keep: Authors, date/time, post number, uuid post, core dev (bool), cooked message, summarized message

Possible prompts

  • Does this message support or refute the proposed PEP?
  • What are key topics found in the message
  • How many times has a person posted
  • You are a Python expert. Summarize this message.
  • You are an intermediate Python user. Summarize this message.
  • You are a manager not a developer. Summarize this message.

Report on pros and cons of the PEP proposal.

Query in 10 message chunks and summarize.

  • Create a visual display of individual posts, summaries, author, and date posted.
  • Display the summaries but allow the original post text to be accessed easily.
  • Plot a sentiment of messages over time.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discuss_nutshell-0.4.0.tar.gz (906.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

discuss_nutshell-0.4.0-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

File details

Details for the file discuss_nutshell-0.4.0.tar.gz.

File metadata

  • Download URL: discuss_nutshell-0.4.0.tar.gz
  • Upload date:
  • Size: 906.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for discuss_nutshell-0.4.0.tar.gz
Algorithm Hash digest
SHA256 8c40d8348e3257a595fc55e0648362ee898a044f2a5e97c115b42e275fec58ad
MD5 4347e3299a76d99be7d4a63e79341661
BLAKE2b-256 9711d8b41da34099aa3af3f1aaf891eb8b3383edc1dfe3c420aab91166f9b53e

See more details on using hashes here.

Provenance

The following attestation bundles were made for discuss_nutshell-0.4.0.tar.gz:

Publisher: cd.yml on willingc/discuss-nutshell

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file discuss_nutshell-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for discuss_nutshell-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9d5360de5d6ff6cc3a788c7607e300cdf75ae1b718aa1226a7dc8058192eb90d
MD5 3850f313918f16e8f04aaa4a6e211b05
BLAKE2b-256 6bf2d26a5e0cbe216bf8756042e33881c867252d833626986343982295357854

See more details on using hashes here.

Provenance

The following attestation bundles were made for discuss_nutshell-0.4.0-py3-none-any.whl:

Publisher: cd.yml on willingc/discuss-nutshell

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page