Divercity

This application allows you to create a visual resource for ethnicities in different places around the world. The project uses the Flickr api to generate the 100 most recent photographs from each query.


Try App

Test email: demo@demo

Test password: demo

About The Project

Register

Search

• Users can search for images and save them to a collection.

Save

• Users can revisit their curated collections from each city.

This project creates diverse selection of images that more accurately represent people who live in a city. This API produces a notably better selection of photos compared to many stock photo providers. Users can opt to personally contact the photographers on Flickr, or use this as a visual resource to understand the cultural diversity of places.

Built With

• Python
• Javascript
• Flask
• Jinja
• SQLalchemy
• postgreSQL

APIs

• Flickr
• Google Places

Front-end

• Javascript
• JQuery
• AJAX
• Bootstrap
• HTML/ CSS

DB Model

Roadmap

MVP

Users are able to query for images of people based on city.

1.0

• Create a search bar that allow user to search for people in a specific city
• Allow users to log into their own account to save pictures

2.0

• Allow users to save pictures to a specific collection
• Create functionality to add/delete photos for a curated collection
• Dynamically add collection with first image and location to user's gallery

3.0 - Current

• Create resources for user to reach out to photographers
• Integrate API for stock photo choices
• Give users the choice to pay for licensed photos
• Allow users to share their collections with other users
• Demo

Installation

1. git clone this repository
2. cd divercity to go to the directory
3. pip3 install -r requirements.txt to install required packages
4. Sign up for an API key at flickr API (You can enter "demo" for both boxes)
5. Create a new file called secrets.sh in the Divercity directory
6. Save your API in this format export API_KEY="xxxxx"/n export API_SECRET="xxxxx"
7. source secrets.sh back in the terminal
8. python3 seed.py to set up database
9. python3 server.py to launch and view on (http://localhost:5000/)!

Run Tests

1. python3 test.py to see individual tests
2. coverage run --source=. --omit="env/*" test.py to not test test.py file
3. coverage report -m to see a report

Screenshot

Screenshot

Contact

Deborah Ong - @debieday - [email protected]

Project Link: http://divercity.deborahong.com/