Skip to main content

CI : Docs CI : Lint CI : Tests PyPI : youcomsum Python : versions License : MIT

Description

Batch summarize YouTube video comments using artificial intelligence (OpenAI, …).

Documentation

Documentation is available on https://dashstrom.github.io/youcomsum

Installation

You can install youcomsum using uv from PyPI

pip install uv
uv tool install youcomsum

Usage

Before use youcomsum, you must set your OPENAI_API_KEY following the Best Practices for API Key Safety.

youcomsum -v 'http://youtu.be/dQw4w9WgXcQ'

Usage as module

from youcomsum import YouComSum

youcomsum = YouComSum()
text: str = youcomsum.summarize("http://youtu.be/dQw4w9WgXcQ")
print(text)

Development

Contributing

Contributions are very welcome. Tests can be run with poe check, please ensure the coverage at least stays the same before you submit a pull request.

Setup

You need to install Poetry and Git for work with this project.

git clone https://github.com/Dashstrom/youcomsum
cd youcomsum
poetry install --all-extras
poetry run poe setup
poetry shell

Poe

Poe is available for help you to run tasks.

test           Run test suite.
lint           Run linters: ruff checker and ruff formatter and mypy.
format         Run linters in fix mode.
check          Run all checks: lint, test and docs.
check-tag      Check if the current tag match the version.
cov            Run coverage for generate report and html.
open-cov       Open html coverage report in webbrowser.
docs           Build documentation.
open-docs      Open documentation in webbrowser.
setup          Setup pre-commit.
pre-commit     Run pre-commit.
commit         Test, commit and push.
clean          Clean cache files.

Skip commit verification

If the linting is not successful, you can’t commit. For forcing the commit you can use the next command :

git commit --no-verify -m 'MESSAGE'

Commit with commitizen

To respect commit conventions, this repository uses Commitizen.

cz c

How to add dependency

poetry add 'PACKAGE'

Ignore illegitimate warnings

To ignore illegitimate warnings you can add :

  • # noqa: ERROR_CODE on the same line for ruff.

  • # type: ignore[ERROR_CODE] on the same line for mypy.

  • # pragma: no cover on the same line to ignore line for coverage.

  • # doctest: +SKIP on the same line for doctest.

Uninstall

pipx uninstall youcomsum

License

This work is licensed under MIT.

Metadata

Release files for youcomsum 0.0.1

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

Source distribution (sdist)

Source distribution for youcomsum 0.0.1
File Size Uploaded
youcomsum-0.0.1.tar.gz 12.3 kB Details

Built distribution (wheel)

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

Total release size: 22.9 kB

Release files / youcomsum-0.0.1.tar.gz

Download URL youcomsum-0.0.1.tar.gz
Size 12.3 kB
Tags Source
SHA-256 checksum
How to use checksums
e95918f5a625b55dfd297f86bd6cab378b3d9332c38546fbc82607fe52a3a5e0
BLAKE2b-256 checksum
How to use checksums
d4233e033df117a6d8aa27a824fccf31d9f5435b389a91093b6289894a3d85f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 22, 2025.

Transparency log

Release files / youcomsum-0.0.1-py3-none-any.whl

Download URL youcomsum-0.0.1-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
040b7dbf14837240d19c04cc907ea8fe3df64932faa91b43881e42a1f8f1c369
BLAKE2b-256 checksum
How to use checksums
b3ef0a560d50639fc54961b7ed2e5a20d347d5ed373749783c32de0e0be60ee9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 22, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.0.1 This release

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