Skip to content

Latest commit

 

History

History
182 lines (113 loc) · 6.79 KB

File metadata and controls

182 lines (113 loc) · 6.79 KB

banner

made-with-python Open Source Love Contributions Welcome View My Profile

PowerPoint Generator is a smart web application that automates the creation of PowerPoint presentations.

This is my first open-source project as a computer science student. 😀 There are so many things for improvements in this web app, so please feel free to contribute to and kindly give me some advice! 😊 (from Less emoji to modifying code or something...🙄)

Features 🎨

  • AI-Driven Content Creation: Utilize the power of GPT-3.5 Turbo to generate slide content based on your input.
  • Intelligent Slide Generation: The tool intelligently proposes titles and content for each slide.
  • Customizable Themes: Choose color themes for your presentation, giving it a personalized touch.
  • User-Friendly Interface: Clear instructions and an intuitive design make the PowerPoint generation process seamless and straightforward.
  • Secure Authentication: Register and log in with peace of mind, as user information is securely stored.

Clone the repo and try 🚀 You need API key, so click here if you don't have it yet. Setup the Secret Key and OpenAI Key 🔑

python3 myapp/flaskapp.py

Demo Highlights 🎬

project_demo.mov

Community Discussions 🗣️

Have a question, idea, or want to contribute? Join us in Discussions!

How to contribute 💛

Step 1: Star The Repo

Star the repo to start your contribution ⭐️

star repo


Step 2: Fork it

On the GitHub page for this repository, click on the Button "Fork".

fork image


Step 3: Clone it
  • Method 1: GitHub Desktop

⚠️ NOTE: If you're not familiar with Git, using GitHub Desktop Application is a better start. If you choose this method, make sure to download it before continuing reading.

❗❗ Access link to download here.

  • Method 2: Git

Clone the forked repository. Open git bash and type:

git clone https://github.com/<your-github-username>/PowerPoint-Generator-Python-Project.git

This makes a local copy of the repository in your machine.

⚠️ Replace <your-github-username>!


Step 4: Create your feature branch

Always keep your local copy of the repository updated with the original repository. Before making any changes and/or in an appropriate interval, follow the following steps:

  • Method 1: GitHub Desktop

Learn more about how to create new branch here and how to fetch and pull origin from/to your local machine here.

Learn more about how to fetch and pull origin from/to your local machine using GitHub Desktop here.

  • Method 2: Git

Run the following commands carefully to update your local repository

# If you cloned a while ago, get the latest changes from upstream
git checkout <master>
git pull upstream <master>

# Make a feature branch (Always check your current branch is up to date before creating a new branch from it to avoid merge conflicts)
git checkout -b <branch-name>

Step 5: Pull Request

Go to the GitHub page of your fork, and make a pull request:

Read more about pull requests on the GitHub help pages.

I'll check your pull request.


Setup the Secret Key and OpenAI Key 🔑

The application uses a secret key for session management and an OpenAI key for the GPT-3.5 Turbo API. These keys are defined as environment variables, and you can easily set them up using the provided .env.example file.

  1. Locate the file named .env.example in the project directory.
  2. Copy the contents of .env.example into a new file named .env.
  3. Replace the placeholder values with your actual keys:
SECRET_KEY=your_secret_key
OPENAI_KEY=your_openai_key
PEXELS_API_KEY=your_pexels_key

Here's a brief description of each key and how to obtain them:

SECRET_KEY: 🔐This is used for web application security such as session management. You can create your own secure, random string for this.

OPENAI_KEY: 🤖This is required to access the OPENAI API. Although there's a limitation with the free version, it's sufficient for trying out this web application on your local machine. You can obtain this key by creating an account on the https://platform.openai.com.

PEXELS_API_KEY: 🏞️ This key is used for the free image search API provided by Pexels. It's very useful for adding creative images to your presentations. You can get this key by creating a free account on the https://www.pexels.com/api After registering, the API key is automatically generated for you.

Contributors ✨

description

Ota Hina

description

Gagandeep Singh

License 📄

This project is licensed under the terms of the MIT license.