Article2Voice

A mini web app that can take an article link, parse the article, and return an audio file.

Clone the repo then install the packages

$ git clone https://github.com/MaxMonteil/Article2Voice.git
$ cd Article2Voice

Server

$ cd server
$ pipenv install

You will need to make an account on the Google Cloud Platform and set up a project using Text to Speech, here's their tutorial:

Cloud Text-to-Speech API Quickstart

Environment Variables

Make sure you make a copy of the env file called .env (dot included) and fill out the paths to your files to ensure all environment variables are automatically set for you.

Dependencies

Extra things you need to make sure you've installed so everything can run and install smoothly.

Python 3
Pip (the version for python 3)
Pipenv
Newspaper3k dependencies link
- You won't need the NLP related libraries

Running the server

Navigate to the server folder and run

pipenv run flask run

It will start up the api server.

Testing

To properly test the back end you will need to use something like Postman to hit the different routes.

You can also open the index.html file in the client folder with a browser and try inputting URLs there.

Route

The API route is at

http://127.0.0.1:5000/api/v1/article/<article url>

Method

GET

Client

Currently there is a simple index.html file there for testing.

To Do

Server

Improve API security
Deploy API to Heroku
Enable audio streaming instead of returning the whole complete file

Client

Implement front-end with React