Help the team

Step 1: Setting up the PeARS environment

First, the best way to get acquainted with the current state of the project is to install the development version. Please follow the instructions here to set things up

Click to expand Instruction set

  1. 1. Clone PeARS repo

    git clone
    cd PeARS-orchard
  2. 2. Setting up the environment

    1. 2.1. Set up virtualenv

      We recommend using virtualenv for the development. If you are just here for test it out, skip to the next section.

      Install pip3 using easy_install
      sudo easy_install pip3

      or some other way your distribution supports like:

      sudo yum install python3-pip
      Install virtualenv using pip3
      sudo pip3 install virtualenv
      Create a new virtualenv for PeARS and activate it
      virtualenv -p python3 env && source env/bin/activate
    2. 2.2. Install the build dependencies

      We recommend using pip for installation. In case you don't have this, look inside requirements.txt and install dependencies manually.

      pip3 install -r requirements.txt
    3. 2.3. Unpack the semantic space

      In the root directory of the repo, run

      cd app/static/spaces

  3. 3. Running the PeARS search engine

    In the root directory of the repo, run


    Go to the browser and type localhost:8080. You should find PeARS running there. You don't have any pages indexed yet, so go to the F.A.Q. page (link at the top of the page) and follow the short instructions to get you going!

Do let us know is anything isn't working for you by opening an issue on the GitHub page!

Step 2: Check for open issues

Check out the current issues in the PeARS repo. You may find something you might like to contribute to. Things are changing quite rapidly, so it is always best to drop us a short line saying you'd like to take on the issue before you actually make a start. We may have more up-to-date info than what is on GitHub!

Step 3: Connect with the Team

if you have other ideas, comments, problems, don't hesitate to contact us, either on the GitHub issue page, or via IRC. One of us is usually hanging about at #pears on Freenode.

  • photo of Aurelie Herbelot

    Aurelie Herbelot

    Computational Linguist

    Having worked as a fluffy toy seller, a mortgage adviser and random other things, Aurelie decided that her real vocation was, in fact, computational semantics. In 2010, she received her PhD in Natural Language Processing from the Computer Laboratory at the University of Cambridge and has been working in research since then. Her work focuses on building computer systems which simulate human language understanding.

  • photo of Aurelie Herbelot

    Behrang QasemiZadeh

    Computer Scientist

    Behrang is a cliché computer scientist! Currently part of a team of linguists, philosophers, and neurocognitive scientists trying to describe a Barsalou-ian uniform structure of representations. His role is to design and write algorithms to simulate or to provide evidence of theoretical findings. This often involves exploring empirical data-driven distributional methods of natural language processing. One of Behrang’s hobbies is also programming! Other than that, he likes playing with his daughter and watching how she picks up the three languages spoken at home.

  • photo of Aurelie Herbelot

    Hrishikesh K. B.

    Python Hacker

    A Pythonista by profession and passion, stultus is addicted to books, coffee, and his computer. As an activist and a social worker, he believes that when you don't like something you say it out loud and if your say is not heard, you act on it. So don't be surprised if you happen to see him on newspapers and other media.

  • photo of Aurelie Herbelot

    Nandaja Varma

    Python Hacker

    Nandaja is a DevOps Engineer who likes to Code in Python and talk about Clojure. Apart from being a self-proclaimed programming languages enthusiast, She fiddles around with systems programming and some low level coding. Other than sitting infront of the computer for prolonged hours, she enjoys playing boardgames, biking, skateboarding, etc.

  • photo of Aurelie Herbelot

    Shobha Tyagi

    PhD Student

    Nature lover, learner, GNOME foundation documentation team member, pursuing PhD in IT, Shobha is working as Assistant Professor. She is fond of eating tasty food but finds it difficult to cook the same.

  • photo of Aurelie Herbelot

    Veesa Norman

    Mysterious Hacker