MIT License

项目介绍

otahina/PowerPoint-Generator-Python-Project 是一个托管在 GitHub 上的开源项目,主要使用 Python 编写,采用 MIT License 许可证,目前获得 412 个 Star、138 次 Fork。

仓库全名
otahina/PowerPoint-Generator-Python-Project
开源许可证
MIT License
Star 数
412
Fork 数
138
未关闭 Issue
2

README 摘要

PowerPoint Generator: Your Gateway to Effortless Presentations 🚀 Dive into the ease of presentation creation with PowerPoint Generator, a smart web application crafted to automate PowerPoint presentations! 🌟 This project is ripe for growth and eager for your contributions. Let's enhance its capability together! 😊 Demo Highlights 🎬…

完整内容见 GitHub 原始 README 或本页 。

常见问题

PowerPoint-Generator-Python-Project 用什么语言开发?

主要使用 Python 编写,采用 MIT License 许可证,目前有 412 个 Star。

PowerPoint-Generator-Python-Project 可以免费商用吗?

仓库采用 MIT License 许可证,可免费使用与修改,商业使用请遵守许可证条款(例如保留版权声明与许可声明)。

如何获取 PowerPoint-Generator-Python-Project 的源码?

可以直接克隆仓库:git clone https://github.com/otahina/PowerPoint-Generator-Python-Project.git,默认分支为 main;安装与运行步骤见仓库 README。

PowerPoint-Generator-Python-Project 最近还在维护吗?

仓库最近一次更新为 2023年11月11日,当前有 2 个未关闭 Issue;Star 数为 412,可作为社区活跃度的参考。

关于

GitHub 原始描述(英文)

Discover the power of GPT-3.5 turbo in presentation creation! 💻🤩 This web application can effortlessly generate captivating PowerPoint presentations. Say goodbye to the struggle of starting from scratch and let AI revolutionize your content creation process. 🎨

描述取自 GitHub 官方 API,保持仓库作者书写的原文。

语言占比

JavaScript
Python

README

banner

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

PowerPoint Generator: Your Gateway to Effortless Presentations 🚀

Dive into the ease of presentation creation with PowerPoint Generator, a smart web application crafted to automate PowerPoint presentations! 🌟 This project is ripe for growth and eager for your contributions. Let’s enhance its capability together! 😊

Demo Highlights 🎬

https://github.com/otahina/PowerPoint-Generator-Python-Project/assets/108225969/82d98c7a-0244-4fed-8f6b-f6c994fd69e3

Table of Contents 📋

  1. Features
  2. Inner Structure of the Project
  3. How to Use
  4. How to Contribute

Features

  • 🤖 AI-Driven Content Creation: Utilize the power of GPT-3.5 Turbo to generate slide content based on user’s 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.

Inner Structure of the project

If you want to learn how to use the GPT API for creating PowerPoint presentations or understand how the project is organized, check out CODE_STRUCTURE.md. 🧐 In this document, I explain the code and the relationships between different parts of the code.

How to use

If you want to try using this project, here is a step-by-step guide. Those who want to contribute to (which is welcome!), please check How to Contribute

Step 1: Star The Repo ⭐️

Star the repo to start using this project 👍

star repo


Step 2: Clone It 🐑
  • Using Git

Open your terminal and run the following command:

git clone https://github.com/otahina/PowerPoint-Generator-Python-Project.git
  • Using Download ZIP
  1. Go to the GitHub page of the repository.
  2. Click on the green Code button.
  3. In the dropdown menu, select Download ZIP.

Step 3: Create a Virtual Environment 📟

On Windows 🪟

  • Open your Command Prompt and navigate to your project’s directory.
  • Run the command line by line.
    python -m venv venv
    .\venv\Scripts\activate
    pip install -r requirements.txt
    

On macOS and Linux 🐧

  • Open your Terminal and navigate to your project’s directory.
  • Run the command line by line.
    python3 -m venv venv
    source venv/bin/activate
    pip install -r requirements.txt
    

Step 4: Setup API Keys 🔑

⚠️ This step is very important to make the project work! please make sure if you set up everything correctly. Instruction ▶️ Setup the Secret Key and OpenAI Key


Step 5: Run 🏃‍

Navigate to myapp directory. Run flaskapp.py

python3 myapp/flaskapp.py

How to contribute

Thank you for considering how you can contribute to the project! ✨

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 terminal (command prompt) 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 main
git remote add upstream https://github.com/otahina/PowerPoint-Generator-Python-Project.git
git pull upstream main

# 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 🖐️
  1. Open the GitHub website and find your forked repository.
  2. On your fork’s GitHub page, click ‘New Pull Request’.
  3. Ensure the base branch is the original repository’s branch you want to merge into(main branch), and the compare branch is your feature branch.
  4. Click ‘Create Pull Request’, add a title and a brief description of your changes.

Thank you for your contribution! I’ll check your pull request. 😀


If you want to learn more about how to contribute, visit CONTRIBUTING.md.

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.

Community Discussions 🗣️

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

Contributors ✨

description Ota Hina description Gagandeep Singh

License 📄

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

评论

暂无评论