Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
130 lines (103 sloc) 7.43 KB

Getting Started with AIP Development

Welcome aboard. We're so happy you are interested in joining the community of AIP developers. We've tried to make it reasonably straightforward for you to get in and start contributing right away. Please work through this 'getting started' guide and consider also joining the Araport-Developers Google Group. Also, make sure to keep an eye on the Araport Developer Zone for new features and announcements.

If you're coming to our November workshop, we suggest you try to get through installation and configuration of the prerequisites to maximize the time you can spend learning new material.

Acquiring the necessary accounts

You need two sets of credentials to develop AIP content:

Installing and configuring dependencies

The list of requirements to start AIP development is relatively minimal, but you do need a few things installed. You also ought to get comfortable using them! We assume that you are developing in Linux or Mac OS X (because they are UNIX-like), but all of these tools are also available and usable under Windows 7 (or better).

  • Git
  • Agave CLI
  • Node.js and npm
  • Python + virtual environment, pip
  • cURL
  • A good text editor
  • Optional: an in-browser REST client

Step 1. git

  1. Installation - Follow the instructions!
  2. Configuration - Make sure to run through the setup, too
  3. Ensure that git is accessible in your $PATH

Step 2. Node.js and npm

Step 3. AgaveAPI command line


git clone
# then, add foundation-cli/bin to your PATH

Initialize the Agave CLI tools. You only need to do this once!

Please select a tenant from the following list:
[2] irec
[4] wso2.agave.staging
Your choice [2]: 0
You are now configured to interact with the APIs at

Create an OAuth2 client and cache its key and secret locally. You only need to do this once!

clients-create -S -N araport_cli
API password:
Successfully created client araport_cli
key: Q23DP_OASIsWxzwa5Ijh_5tUYw_H
secret: pDDGdirnNTsOuW4Yh6EwaCMsU6ga

Step 4. Python + virtual environments and pip

Follow all the steps in the guide for your operating system. After installing virtualenv and pip, install virtualenvwrapper

Step 5. Install cURL

Check to see if cURL is on your system already. If it's not, install it using a package manager or by downloading it from the cURL web site. Make sure it's in your $PATH after installation.

Step 6. Choose a text editor

You have many to choose from! If you don't have a favorite yet, might we suggest

  • Atom - Free, powerful, extensible, and open source
  • Sublime Text - It's 70 bucks but hey, you're on a $2000 laptop, right?
  • TextWrangler - Free-as-in-beer and awesome, but Mac OS X only.
  • EMACS or vim - Non-GUI editors but extremely flexible

Step 6. Optional REST client

Brushing up on the basics

We've tried to distill down the bare minimum of material needed to create Araport apps and data APIs. If some of this is new, don't worry. You'll get more experience working through the worked example tutorials we will be publishing.

Diving deeper with additional resources

The Araport project stands on the shoulders of giants, so there's a lot of other background or reference material that you might be interested in. Here are a few suggested resources to broaden your knowledge base.