elanatee / quotifai

web app that uses image recognition + web scraping to find quotes relevant to images 📷

quotifai 📷

a web app that displays a quote related to a submitted image

technologies used:

• Clarifai API
• Flask
• BeautifulSoup
• virtualenv

how it works

• demo.py uses Clarifai's image recognition API to analyze an image and generate a list of tags based on the image content
• scraper.py retrieves quotes from Goodreads.com based on the image tags.

setup + run

to get this code up and running on your own machine,

0. make sure you have Python and the pip package installer
1. clone this repository (or download it to your desktop)
2. in terminal, navigate to the project directory

   $ cd /path/to/quotifai
   

3. install the required Python packages

   $ pip install -r requirements.txt
   

4. get a Clarifai API key from developer.clarifai.com and follow these instructions (under Setup) to configure it on your machine
5. tell Flask which application to work with by setting the FLASK_APP environment variable:
   • on MacOS/Linux: $ export FLASK_APP=app.py
   • on Windows: $ set FLASK_APP=app.py
6. now you can run the app using flask run, and navigate to http://127.0.0.1:5000/ to see it live! your terminal should look like this:

   $ flask run
    * Serving Flask app "app"
    * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
   

resources & further reading

• Clarifai API Python Client
• The Flask Mega-Tutorial, Part III: Web Forms by Miguel Grinberg
• Flask Quickstart

thanks!

feedback and pull requests are warmly welcomed and encouraged!

tweet me @elanatee if you have any questions!