Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A photo manipulation application named Instapute, hosted on Google App Engine. The application can perform various image manipulation tasks on a large number of images. The use case design demonstrates these tasks by resizing 4 images and composites them together to create a single image. This application used to run online here, but it has been taken down for now.

Screenshot of app


Written in Python, using GAE, Instapute uses the following technology:

  • Flask a Python micro framework
  • WebApp2 a Python web framework for easy routing with GAE
  • The following Google App Engine APIs
    • App Identity to get the name of a bucket to store photos in
    • Push Task Queues to queue up tasks, such as a new job to create a collage for a particular instagram user, or resize 4 images to a single image.
    • Services (previously named modules), to separate the program into several microservices ... 'Microservices allow a large application to be decomposed into independent constituent parts, with each part having its own realm of responsibility.' ... Cloud Computing benifits, such as autoscaling, load balancing, and machine instance types are all managed independently for services.
  • The following Google App Engine Storage systems

The program is setup with the following structure:

- templates/
    directory contains all html templates
- static/
    directory contains all static files, such as .css files or .js files
- Imaging-1.1.7/
    directory contains PIL Imaging library so the GAE development server can process image functions (needed?)
- requests/
    directory contains requests library so the GAE dev server can process requests api functions (needed?)
    to use the above libraries
- makefile
    to make the flask project (needed?)
    defines a GAE Google Cloud Datastore for an Entity
- requirements.txt
    defines all libraries required
- The following 3 micro-services
  - front-end
      defined in with app.yaml
  - download-photos
      defined in with download-photos.yaml
  - build-image
      defined in with build-image.yaml

Initial Setup

  1. Setup a Google Cloud project gcloud init
  2. Set the project to be the name (ccinstapute) gcloud source repos clone default --project=ccinstapute
  3. Pull and deploy (see SETUP below)


  1. Install Python 2.7 and PIP
  2. Pull repo
  3. Install all requirements into a folder in the directory instapute/lib/
  4. Run the makefile to test locally
  1. Commit to repo, could use a shorthand to commit with no message
  • git add . && git commit -am. && git push


  1. When commited to Github Repo, go to cloud console
  1. Type the following to pull
  • cd src/default
  • git pull
  1. Test locally by running
  • git pull && app.yaml download-photos.yaml build-image.yaml
  • Click preview in browser button
  1. Deploy by running
  • gcloud app deploy app.yaml download-photos.yaml build-image.yaml
  • Y
  1. View app at location

Uses Instagram API from 16bestof16

Instagram API call<username>

Navigates the JSON to get photos with a python call like:

for each photos

Example JSON response from API

            "name":"Location Name"