initial commit

.gitattributes

@@ -0,0 +1,2 @@
+*.ipynb linguist-vendored
+*.sh text eol=lf

.github/workflows/update_space.yml

@@ -0,0 +1,28 @@
+name: Run Python script
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.9'
+
+    - name: Install Gradio
+      run: python -m pip install gradio
+
+    - name: Log in to Hugging Face
+      run: python -c 'import huggingface_hub; huggingface_hub.login(token="${{ secrets.hf_token }}")'
+
+    - name: Deploy to Spaces
+      run: gradio deploy

.gitignore

@@ -0,0 +1,126 @@
+.pypirc
+
+specs/
+docs/
+data/
+
+*.ipynb
+
+*.whl
+*.wheels
+
+# Exclude aliases file
+alias.sh
+
+*.ipynb_checkpoints
+
+# Python-specific ignores
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environment
+venv/
+env/
+.env
+
+# IDE-specific files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS-specific files
+.DS_Store
+Thumbs.db
+
+# Project-specific ignores
+attachments/
+
+# Logs
+*.log
+
+# Temporary files
+*.tmp
+
+# Compiled Python files
+*.pyc
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# Poetry
+poetry.lock
+.poetry/
+
+# Poetry
+.venv/
+dist/
+
+# Python
+*.pyc
+__pycache__/
+*.egg-info/

README.md

@@ -0,0 +1,111 @@
+---
+title: Podcastfy.ai_demo
+app_file: podcastfy-app/app.py
+sdk: gradio
+sdk_version: 4.44.1
+python_version: 3.11
+---
+# Podcastfy.ai
+[![CodeFactor](https://www.codefactor.io/repository/github/souzatharsis/podcastfy/badge)](https://www.codefactor.io/repository/github/souzatharsis/podcastfy)
+[![PyPi Status](https://img.shields.io/pypi/v/podcastfy)](https://pypi.org/project/podcastfy/)
+[![Downloads](https://pepy.tech/badge/podcastfy)](https://pepy.tech/project/podcastfy)
+[![Issues](https://img.shields.io/github/issues-raw/souzatharsis/podcastfy)](https://github.com/souzatharsis/podcastfy/issues)
+[![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)
+
+Transforming Multi-Sourced Text into Captivating Multi-Lingual Audio Conversations with GenAI
+
+https://github.com/user-attachments/assets/f1559e70-9cf9-4576-b48b-87e7dad1dd0b
+
+Podcastfy is an open-source Python package that transforms web content, PDFs, and text into engaging, multi-lingual audio conversations using GenAI. 
+
+Unlike UI-based tools focused primarily on note-taking or research synthesis (e.g. NotebookLM ❤️), Podcastfy focuses on the programmatic and bespoke generation of engaging, conversational transcripts and audio from a multitude of text sources therefore enabling customization and scale.
+
+## Audio Examples
+
+This sample collection is also [available at audio.com](https://audio.com/thatupiso/collections/podcastfy):
+- [English] Book Networks, Crowds, and Markets: [audio](https://audio.com/thatupiso/audio/networks)
+- [English] Research paper: ([audio](https://audio.com/thatupiso/audio/agro-paper) | [pdf](./data/pdf/s41598-024-58826-w.pdf))
+- [English] Personal website: ([audio](https://audio.com/thatupiso/audio/tharsis) | [website](https://www.souzatharsis.com))
+- [English] Personal website + youtube video: ([audio](https://audio.com/thatupiso/audio/tharsis-ai) | [website](https://www.souzatharsis.com) | [youtube](https://www.youtube.com/watch?v=sJE1dE2dulg))
+- [French] Website: ([audio](https://audio.com/thatupiso/audio/podcast-fr-agro) | [website](https://agroclim.inrae.fr/))
+- [Portuguese-BR] News article: ([audio](https://audio.com/thatupiso/audio/podcast-thatupiso-br) | [website](https://noticias.uol.com.br/eleicoes/2024/10/03/nova-pesquisa-datafolha-quem-subiu-e-quem-caiu-na-disputa-de-sp-03-10.htm))
+
+## Quickstart
+
+### Setup
+Before installing, ensure you have Python 3.12 or higher installed on your system.
+
+1. Install from PyPI
+
+  `$ pip install podcastfy`
+
+2. Set up your [API keys](usage/config.md)
+
+3. Ensure you have ffmpeg installed on your system, required for audio processing
+```
+sudo apt update
+sudo apt install ffmpeg
+```
+
+### Python
+```python
+from podcastfy.client import generate_podcast
+
+audio_file = generate_podcast(urls=["<url1>", "<url2>"])
+```
+### CLI
+```
+python -m podcastfy.client --url <url1> --url <url2>
+```
+
+## Usage
+
+- [Python Package](podcastfy.ipynb)
+
+- [CLI](usage/cli.md)
+
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request - see [Open Issues](https://github.com/souzatharsis/podcastfy/issues) for ideas. But even more excitingly feel free to fork the repo and create your own app! Please let me know if I could be of help.
+
+## Features
+
+- Generate engaging, AI-powered conversational content from multiple sources (URLs and PDFs)
+- Create high-quality transcripts from diverse textual information sources
+- Convert pre-existing transcript files into dynamic podcast episodes
+- Support for multiple advanced text-to-speech models (OpenAI and ElevenLabs) for natural-sounding audio
+- Support for multiple languages, enabling global content creation
+- Seamlessly integrate CLI for streamlined workflows
+
+## Example Use Cases
+
+1. **Content Summarization**: Busy professionals can stay informed on industry trends by listening to concise audio summaries of multiple articles, saving time and gaining knowledge efficiently.
+
+2. **Language Localization**: Non-native English speakers can access English content in their preferred language, breaking down language barriers and expanding access to global information.
+
+3. **Website Content Marketing**: Companies can increase engagement by repurposing written website content into audio format, providing visitors with the option to read or listen.
+
+4. **Personal Branding**: Job seekers can create unique audio-based personal presentations from their CV or LinkedIn profile, making a memorable impression on potential employers.
+
+5. **Research Paper Summaries**: Graduate students and researchers can quickly review multiple academic papers by listening to concise audio summaries, speeding up the research process.
+
+6. **Long-form Podcast Summarization**: Podcast enthusiasts with limited time can stay updated on their favorite shows by listening to condensed versions of lengthy episodes.
+
+7. **News Briefings**: Commuters can stay informed about daily news during travel time with personalized audio news briefings compiled from their preferred sources.
+
+8. **Educational Content Creation**: Educators can enhance learning accessibility by providing audio versions of course materials, catering to students with different learning styles.
+
+9. **Book Summaries**: Avid readers can preview books efficiently through audio summaries, helping them make informed decisions about which books to read in full.
+
+10. **Conference and Event Recaps**: Professionals can stay updated on important industry events they couldn't attend by listening to audio recaps of conference highlights and key takeaways.
+
+
+## License
+
+This project is licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/).
+
+## Disclaimer
+
+This tool is designed for personal or educational use. Please ensure you have the necessary rights or permissions before using content from external sources for podcast creation. All audio content is AI-generated and it is not intended to clone real-life humans!

install.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+set -e
+
+echo "Starting custom installation script..."
+
+# Upgrade pip
+echo "Upgrading pip..."
+pip install --upgrade pip
+
+
+
+# If you have any specific packages that need special handling, install them here
+# For example:
+# echo "Installing specific package..."
+# pip install some-package==1.2.3
+
+# List installed packages
+echo "Listing installed packages:"
+pip list
+
+echo "Custom installation script completed."
+
+python -m ensurepip --upgrade
+python -m pip install --upgrade setuptools