From ec9855ad3cf062f4636d5cda9f4c1c3a4d22de83 Mon Sep 17 00:00:00 2001 From: Rajtilak Bhattacharjee Date: Fri, 10 Nov 2023 20:49:41 +0530 Subject: [PATCH] chore: update dependency requirements and documentation setup - Updated requirements.txt to reflect changes in dependencies. - Installed all necessary dependencies, including development dependencies. - Implemented documentation using MkDocs with the Material theme for comprehensive project documentation. --- docs/acknowledgement.md | 8 ++++++ docs/development.md | 19 +++++++++++++ docs/index.md | 49 ++++++++++++++++++++++++++++++++ docs/resources.md | 6 ++++ docs/usage.md | 17 +++++++++++ mkdocs.yml | 62 +++++++++++++++++++++++++++++++++++++++++ requirements.txt | 3 +- 7 files changed, 162 insertions(+), 2 deletions(-) create mode 100644 docs/acknowledgement.md create mode 100644 docs/development.md create mode 100644 docs/index.md create mode 100644 docs/resources.md create mode 100644 docs/usage.md create mode 100644 mkdocs.yml diff --git a/docs/acknowledgement.md b/docs/acknowledgement.md new file mode 100644 index 0000000..ee65493 --- /dev/null +++ b/docs/acknowledgement.md @@ -0,0 +1,8 @@ +This project has been heavily borrowed and improved upon the work by [Adam Tal](https://github.com/AdmTal/crowdcast). + +## Music + +- Music by Sergio Prosvirini from Pixabay +- Music by Bohdan Kuzmin from Pixabay +- Music by Oleksii Kaplunskyi from Pixabay +- Music by Oliver Moilanen from Pixabay diff --git a/docs/development.md b/docs/development.md new file mode 100644 index 0000000..dee7062 --- /dev/null +++ b/docs/development.md @@ -0,0 +1,19 @@ +# Pointers for Developers + +## How to start + +- If you want to develop in a local environment, simply clone the repo `git clone https://github.com/rajtilakjee/kyms.git` and start developing. +- If you want to develop on a Gitpod, click on the following link: + + [Open in Gitpod](https://gitpod.io/#https://github.com/rajtilakjee/kyms-cli) + +## Dependencies + +- All the dependencies for the library are given in the `requirements.txt` files. You can use `pip -r install requirements.txt` to install the dependencies. + +## Dev Dependencies + +There are only 2 dev dependencies as of now: + +- black +- ruff diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..9f94263 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,49 @@ +
+

+ KeepYourMouthShut +

+

+ Acid Reflux for your Ears! +

+

+ +![GitHub commit activity (branch)](https://img.shields.io/github/commit-activity/t/rajtilakjee/keepyourmouthshut) . ![Netlify](https://img.shields.io/netlify/b1b62d2d-3ac1-4559-a94c-445226a2baa1) . ![GitHub](https://img.shields.io/github/license/rajtilakjee/keepyourmouthshut) . ![Website](https://img.shields.io/website?url=https%3A%2F%2Fwww.keepyourmouthshut.net%2F) . ![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/rajtilakjee/keepyourmouthshut) . ![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/rajtilakjee) + +Calm down! KeepYourMouthShut is a Python app that provides an AI-assisted 360-degree solution to all your Podcast requirements. From writing the scripts to providing an unique voice, kyms has the ability to produce an entire episode for your Podcast all by itself. Here are a few features of KYMS CLI: + +- **Smart Script Creation** – Effortlessly generate captivating podcast scripts using advanced Al algorithms, from content structure to engaging narratives. +- **Dynamic Voice Synthesis** – Infuse life into your podcasts with natural voice synthesis, choosing from a variety of professional-grade voices. +- **Continuous Enhancement** – Benefit from ongoing updates and refinements that leverage user feedback and emerging technologies. +- **Ad Integration and Monetization** – Seamless integration of advertisements into your podcast episodes while maintaining a listener-friendly experience. +- **Comprehensive Support** – Customer support for troubleshooting, and technical assistance, ensuring a smooth podcasting experience. +- **Cutting-Edge Tech Utilization** – Harness the latest advancements in Al and speech synthesis technology to elevate your podcast production. + +## Tech Stack + +- elevenlabs +- pydub +- PyYAML +- openai +- streamlit + +## Sample show created with kyms + +- [Listenology on Spotify](https://open.spotify.com/show/4NSKdBlpOuet1YkSoyXJSN?si=95a6075c26f54860) +- [Listenology on Spotify for Podcasters](https://podcasters.spotify.com/pod/show/listenology) +- [Listenology on Apple Podcasts](https://podcasts.apple.com/us/podcast/listenology/id1697707441) + +## Citation + +If you work upon this library of with this library, please refer to it as follows: + +``` +cff-version: 1.2.0 +message: "If you use this software, please cite it as below." +authors: +- family-names: "Bhattacharjee" + given-names: "Rajtilak" +title: "keepyourmouthshut" +version: 1.0.0 +date-released: 2023-11-10 +url: "https://github.com/rajtilakjee/keepyourmouthshut" +``` diff --git a/docs/resources.md b/docs/resources.md new file mode 100644 index 0000000..3a496c5 --- /dev/null +++ b/docs/resources.md @@ -0,0 +1,6 @@ +## Useful links + +- Website: [https://www.keepyourmouthshut.net/](https://www.keepyourmouthshut.net/) +- GitHub repo: [https://github.com/rajtilakjee/kyms](https://github.com/rajtilakjee/kyms-cli) +- PyPi: [https://pypi.org/project/kyms/](https://pypi.org/project/kyms-cli/) +- Reddit: [https://www.reddit.com/r/KeepYourMouthShut/](https://www.reddit.com/r/KeepYourMouthShut/) diff --git a/docs/usage.md b/docs/usage.md new file mode 100644 index 0000000..e9989b9 --- /dev/null +++ b/docs/usage.md @@ -0,0 +1,17 @@ +# How to install KYMS CLI + +## Using pip + +The simples way to install kyms is using the following command: + +``` +pip install kyms-cli +``` + +## How to use + +Once install, use the following command to generate a complete podcast episode: + +``` +kyms-cli gencast +``` diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..445cb5a --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,62 @@ +site_name: KeepYourMouthShut +site_description: Acid Reflux for your Ears! +site_author: Rajtilak Bhattacharjee +site_url: https://www.keepyourmouthshut.net + +repo_url: https://github.com/rajtilakjee/keepyourmouthshut +repo_name: keepyourmouthshut +theme: + name: material + palette: + # Palette toggle for light mode + - scheme: default + primary: deep purple + toggle: + icon: material/weather-night + name: Switch to dark mode + + # Palette toggle for dark mode + - scheme: slate + primary: deep purple + toggle: + icon: material/weather-sunny + name: Switch to light mode + icon: + repo: fontawesome/brands/github + features: + - search.suggest + - search.highlight + - search.share + - navigation.top + - navigation.footer + - navigation.tabs + - navigation.tabs.sticky + +extra: + social: + - icon: fontawesome/brands/github + link: https://github.com/rajtilakjee + - icon: fontawesome/brands/twitter + link: https://twitter.com/rajtilakjee + - icon: fontawesome/brands/linkedin + link: https://www.linkedin.com/in/rajtilak/ + - icon: fontawesome/brands/discord + link: https://discordapp.com/users/969666251536347146 + +plugins: + - search: + lang: en + +markdown_extensions: + - attr_list + - md_in_html + +copyright: >- + Copyright © 2023 Rajtilak Bhattacharjee + +nav: + - Home: index.md + - Usage: usage.md + - Development: development.md + - Resources: resources.md + - Acknowledgement: acknowledgement.md diff --git a/requirements.txt b/requirements.txt index fc04d76..fca914c 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,6 +1,5 @@ -typer[all] elevenlabs pydub -pyyaml +PyYAML openai streamlit