Distributed Crawler Management Framework Based on Scrapy, Scrapyd, Scrapyd-Client, Scrapyd-API, Django and Vue.js
Clone or download
Latest commit 6e5785a Sep 13, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
Deploy_Python3 fix ansible-playbooks Apr 8, 2018
docker Add Deploy Python3 Ansible-playbooks Feb 27, 2018
docs add simple docs May 14, 2018
gerapy update parser Jul 20, 2018
.gitignore update scheduler Jul 11, 2018
LICENSE update setup Oct 10, 2017
MANIFEST.in fix version bug Oct 16, 2017
README.md Update README.md Sep 13, 2018
dev.md fix bug Mar 19, 2018
requirements.txt process custom settings Jul 20, 2018
setup.py add scheduler Jul 10, 2018



Distributed Crawler Management Framework Based on Scrapy, Scrapyd, Scrapyd-Client, Scrapyd-API, Django and Vue.js.


Gerapy is developed over Python 3.x. Python 2.x will be supported later.


Install Gerapy by pip:

pip3 install gerapy

After the installation, you need to do these things below to run Gerapy server:

If you have installed Gerapy successfully, you can use command gerapy. If not, check the installation.

First use this command to initialize the workspace:

gerapy init

Now you will get a folder named gerapy.

Then cd to this folder, and run this command to initialize the Database:

cd gerapy
gerapy migrate

Next you can runserver by this command:

gerapy runserver

Then you can visit http://localhost:8000 to enjoy it.

Or you can configure host and port like this:

gerapy runserver

Then it will run with public host and port 8888.

You can create a configurable project and then configure and generate code automatically.Also you can drag your Scrapy Project to gerapy/projects folder. Then refresh web, it will appear in the Project Index Page and comes to un-configurable, but you can edit this project in the web interface.

As for the deploy, you can move to Deploy Page. Firstly you need to build your project and add client in the Client Index Page, then you can deploy the project by clicking button.

After the deployment, you can manage the job in Monitor Page.


Just run this command:

docker run -d -v ~/gerapy:/app/gerapy -p 8000:8000 thsheep/gerapy:master

Then it will run at port 8000.


docker run -d -v <your_workspace>:/app/gerapy -p <public_port>:<container_port> thsheep/gerapy:master

Please specify your workspace to mount Gerapy workspace by -v <your_workspace>:/app/gerapy and specify server port by -p <public_port>:<container_port>.

If you run Gerapy by Docker, you can visit Gerapy website such as http://localhost:8000 and enjoy it, no need to do other initialzation things.


Client Management:

Spider Monitor:

Project Management:

Project Edit:

Project Deploy:

Project Configuration:


  • Add Visual Configuration of Spider with Previewing Website
  • Add Scrapyd Auth Management
  • Add Automatic Python & Scrapyd Environment Deployment
  • Add MongoDB & Redis & MySQL Monitor
  • Add Timed Task Scheduler


If you have any questions or ideas, you can join this QQ Group: