scrapy/docs/intro/install.rst

5.1 KiB

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> </head>

Installation guide

This document describes how to install Scrapy on Linux, Windows and Mac OS X.

Requirements

Install Python

First, you need to install Python, if you haven't done so already.

Scrapy works with Python 2.5, 2.6 or 2.7, which you can get at http://www.python.org/download/

System Message: ERROR/3 (<stdin>, line 36)

Unknown directive type "seealso".

.. seealso:: :ref:`faq-python-versions`

System Message: ERROR/3 (<stdin>, line 38)

Unknown directive type "highlight".

.. highlight:: sh

Install Scrapy

There are many ways to install Scrapy. Pick the one you feel more comfortable with.

Download and install an official release

Download Scrapy from the Download page. Scrapy is distributed in two ways: a source code tarball (for Unix and Mac OS X systems) and a Windows installer (for Windows). If you downloaded the tarball, you can install it as any Python package using setup.py:

tar zxf Scrapy-X.X.X.tar.gz
cd Scrapy-X.X.X
python setup.py install

If you downloaded the Windows installer, just run it.

Warning

In Windows, you may need to add the C:\Python25\Scripts (or C:\Python26\Scripts) folder to the system path by adding that directory to the PATH environment variable from the Control Panel.

Installing with easy_install

You can install Scrapy using setuptools's easy_install with:

easy_install -U Scrapy

Installing with pip

You can install Scrapy using pip with:

pip install Scrapy

Platform specific instructions

Linux

Ubuntu 9.10 or above

If you're running Ubuntu 9.10 (or above), use the official :ref:`Ubuntu Packages <topics-ubuntu>`, which already solve all dependencies for you and are continuously updated with the latest bug fixes.

System Message: ERROR/3 (<stdin>, line 103); backlink

Unknown interpreted text role "ref".

Debian or Ubuntu (9.04 or older)

If you're running Debian Linux, run the following command as root:

apt-get install python-twisted python-libxml2 python-pyopenssl python-simplejson

And then follow the instructions in :ref:`intro-install-scrapy`.

System Message: ERROR/3 (<stdin>, line 114); backlink

Unknown interpreted text role "ref".

Arch Linux

If you are running Arch Linux, run the following command as root:

pacman -S twisted libxml2 pyopenssl python-simplejson

And then follow the instructions in :ref:`intro-install-scrapy`.

System Message: ERROR/3 (<stdin>, line 123); backlink

Unknown interpreted text role "ref".

Other Linux distros

The easiest way to install Scrapy in other Linux distros is through easy_install, which will automatically install Twisted and lxml as dependencies. See :ref:`intro-install-easy`.

System Message: ERROR/3 (<stdin>, line 128); backlink

Unknown interpreted text role "ref".

Another way would be to install dependencies, if you know the packages in your distros that meets them. See :ref:`intro-install-requirements`.

System Message: ERROR/3 (<stdin>, line 132); backlink

Unknown interpreted text role "ref".

Mac OS X

The easiest way to install Scrapy on Mac is through easy_install, which will automatically install Twisted and lxml as dependencies.

See :ref:`intro-install-easy`.

System Message: ERROR/3 (<stdin>, line 141); backlink

Unknown interpreted text role "ref".

Windows

There are two ways to install Scrapy in Windows:

</html>