Code Monkey home page Code Monkey logo

supersummarizeai's Introduction

SuperSummarizeAI

Description

SuperSummarizeAI is a versatile Python tool designed to extract and summarize textual content. Whether it's from a provided webpage URL, a YouTube video link, or a PDF file, this tool processes the content through ChatGPT to generate an insightful summary. Once the summary is ready, the tool copies the content directly to your clipboard for quick access and sharing. Additionally, with its multilingual capabilities, SuperSummarizeAI can cater to a global audience, generating summaries in various languages.

Installation

Using pip (Recommended for all platforms)

  1. Install SuperSummarizeAI using pip:
pip install ssai
  1. Set your OpenAI key using the following command, replacing YOUR_OPENAI_KEY with your actual OpenAI key (You can get one here):
ssai --OPENAI_KEY=YOUR_OPENAI_KEY

Using Homebrew (macOS)

  1. Tap into the SuperSummarizeAI repository:
brew tap alexandrevl/supersummarizeai
  1. Install SuperSummarizeAI:
brew install ssai
  1. Set your OpenAI key using the following command, replacing YOUR_OPENAI_KEY with your actual OpenAI key (You can get one here):
ssai --OPENAI_KEY=YOUR_OPENAI_KEY

Manual Installation

  1. Ensure you have Python 3 installed on your system.
  2. Clone the repository to your local machine:
git clone https://github.com/alexandrevl/SuperSummarizeAI.git
  1. Navigate to the cloned directory:
cd SuperSummarizeAI
  1. Install the required packages using pip:
pip install -r requirements.txt
  1. Set your OpenAI key using the following command, replacing YOUR_OPENAI_KEY with your actual OpenAI key (You can get one here):
python ssai.py --OPENAI_KEY=YOUR_OPENAI_KEY

For security reasons, always ensure that your .env file remains confidential. Do not share or expose it as it contains sensitive API credentials.

Usage

If Installed via pip or Homebrew:

Simply provide the desired URL (webpage or YouTube video) or PDF file as a command-line argument:

ssai <TARGET>

For instance:

ssai https://example.com

or

ssai MY_PDF.pdf

For multilingual summaries, specify your desired language using the --lang option (default is 'brazilian portuguese'):

ssai <TARGET> --lang <desired_language>

For instance:

ssai https://example.com --lang english

For adding context to the AI, use the --context option:

ssai <TARGET> --context <context>

For instance:

ssai https://youtube.com/watch?v=example --context "The name of the presenter is John Doe"

For more information on the available options, run:

ssai --help

If Installed Manually:

To employ SuperSummarizeAI, provide the desired URL (webpage or YouTube video) or PDF file as a command-line argument:

python ssai.py <TARGET>

For instance:

python ssai.py https://example.com

or

python ssai.py MY_PDF.pdf

For multilingual summaries, specify your desired language using the --lang option (default is 'brazilian portuguese'):

python ssai.py <TARGET> --lang <desired_language>

For instance:

python ssai.py https://example.com --lang english

For give a context to the AI, use the --context option:

python ssai.py <TARGET> --context <context>

For instance:

python ssai.py https://youtube.com/watch?v=example --context "The name of presenter is John Doe"

For more information on the available options, run:

python ssai.py --help

๐Ÿ“ธ Examples

See SuperSummarizeAI in action:

Webpage Summarization:

Example of webpage summarization

YouTube Video Summarization:

Example of YouTube video summarization

Troubleshooting

  • TARGET Input: Make sure the URL you input is correctly formatted and always begins with http:// or https://. For PDF files, ensure the file is in the same directory as the script or provide the full path to the file.
  • Dependencies: Double-check to ensure all required dependencies are correctly installed. If you encounter any errors, try reinstalling the dependencies using pip install -r requirements.txt.

Contributing

Interested in contributing to SuperSummarizeAI? We'd love to collaborate! Please initiate by opening an issue to discuss the changes you'd like to make.

License

Licensed under MIT.

supersummarizeai's People

Contributors

alexandrevl avatar jjohare avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.