Installation

System-Wide Installation

Installing the internetarchive library globally on your system can be done with pip. This is the recommended method for installing internetarchive (see below for details on installing pip). If you are on Mac OS X, refer to the Mac OS X section below before proceeding. Once you’re ready to install, run the following command:

$ sudo python3 -m pip install internetarchive

Updating Your $PATH

Once you have successfully installed internetarchive, you may need to update your $PATH (e.g. if running ia in your terminal returns an error). If you receive a command not found error, run the following command to update your $PATH:

$ echo "$(python3 -m site --user-base)/bin" | sudo tee -a /etc/paths

Updating ia

To update, you can run the following command:

$  sudo python3 -m pip install --upgrade internetarchive

Mac OS X

While newer versions Mac OS X ship with Python 3 installed, it is recommended to install an updated version of Python 3. You can do so with Homebrew:

$ brew install python3

Installing Pip

If you are running Python 3.4+, you should already have pip installed. If it is not already installed, it can be installed with the get-pip.py script:

$ curl -LOs https://bootstrap.pypa.io/get-pip.py
$ python3 get-pip.py

virtualenv

If you don’t want to, or can’t, install the package system-wide you can use virtualenv to create an isolated Python environment.

First, make sure virtualenv is installed on your system. If it’s not, you can do so with pip:

$ sudo python3 -m pip install virtualenv

Or your systems package manager, apt-get for example:

$ sudo apt-get install python-virtualenv

Once you have virtualenv installed on your system, create a virtualenv:

$ mkdir myproject
$ cd myproject
$ virtualenv venv
New python executable in venv/bin/python
Installing setuptools, pip............done.

Activate your virtualenv:

$ . venv/bin/activate

Install internetarchive into your virtualenv:

$ pip install internetarchive

Binaries

Binaries are also available for the ia command-line tool:

$ curl -LOs https://archive.org/download/ia-pex/ia
$ chmod +x ia

Binaries are generated with PEX. The only requirement for using the binaries is that you have Python 3 installed on a Unix-like operating system.

For more details on the command-line interface please refer to the README, or ia help.

Python 2

If you are on an older operating system that only has Python 2 installed, it’s highly suggested that you upgrade to Python 3. If for any reason you are not able to, the latest version of ia that supports Python 2 is 2.3.0.

You can install and use version v2.3.0 with pip:

$ sudo python2 -m pip install internetarchive==2.3.0

You can also download a binary of v2.3.0:

$ curl -LOs https://archive.org/download/ia-pex/ia-py2
$ chmod +x ia-py2

Get the Code

Internetarchive is actively developed on GitHub.

You can either clone the public repository:

$ git clone git://github.com/jjjake/internetarchive.git

Download the tarball:

$ curl -OL https://github.com/jjjake/internetarchive/tarball/master

Or, download the zipball:

$ curl -OL https://github.com/jjjake/internetarchive/zipball/master

Once you have a copy of the source, you can install it into your site-packages easily:

$ python setup.py install