{"id":15195460,"url":"https://github.com/o19s/relevant-search-book","last_synced_at":"2025-04-06T04:10:46.863Z","repository":{"id":27086044,"uuid":"30552922","full_name":"o19s/relevant-search-book","owner":"o19s","description":"Code and Examples for Relevant Search","archived":false,"fork":false,"pushed_at":"2023-06-20T08:55:57.000Z","size":5525,"stargazers_count":310,"open_issues_count":11,"forks_count":109,"subscribers_count":47,"default_branch":"master","last_synced_at":"2025-03-30T03:05:03.752Z","etag":null,"topics":["elasticsearch","ipython-notebook","relevance","relevant-search","solr"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/o19s.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-02-09T19:06:46.000Z","updated_at":"2025-03-25T21:41:39.000Z","dependencies_parsed_at":"2022-09-13T12:13:29.262Z","dependency_job_id":"582d4839-a633-4cfb-ad7a-db920ddd4e48","html_url":"https://github.com/o19s/relevant-search-book","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o19s%2Frelevant-search-book","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o19s%2Frelevant-search-book/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o19s%2Frelevant-search-book/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o19s%2Frelevant-search-book/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/o19s","download_url":"https://codeload.github.com/o19s/relevant-search-book/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247430870,"owners_count":20937874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["elasticsearch","ipython-notebook","relevance","relevant-search","solr"],"created_at":"2024-09-27T23:23:55.930Z","updated_at":"2025-04-06T04:10:46.776Z","avatar_url":"https://github.com/o19s.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Relevant Search\n\nCode and Examples for [Relevant Search](http://manning.com/turnbull) by [Doug Turnbull](http://github.com/softwaredoug) and [John Berryman](http://github.com/jnbrymn). Published by [Manning Publications](http://manning.com).\n\nRelevant Search is all about leveraging Solr and Elasticsearch to build more intelligent search applications with intuitive results!\n\n# How to run\n\n## Install Python\n\nExamples for this book are written in Python 2.7 and use iPython notebook. The first thing you'll need to do is install Python, pip (the Python package installer).\n\n1. Install Python for your platform [here](https://www.python.org/downloads/). For Windows we recommend the [ActivePython](http://www.activestate.com/activepython) distribution.\n2. Install pip, the Python installer, by simply running `easy_install pip`\n\n## Install Elasticsearch\n\nThe examples expect Elasticsearch to be hosted at localhost:9200. So you'll need to install Elasticsearch to work with the examples. There's two ways to install Elasticsearch\n\n### Recommended: Vagrant\n\nVagrant is a tool for installing and provisioning virtual machines locally for development purposes. If you've never used vagrant, you can follow the installation instructions [here](https://docs.vagrantup.com/v2/installation/). OpenSource Connections maintains a basic Elasticsearch vagrant box [here](https://github.com/o19s/elasticsearch-vagrant).\n\nTo use the vagrant box\n\n1. Install vagrant\n2. Clone the Elasticsearch vagrant box from Github locally\n\n   ```\n   git clone git@github.com:o19s/elasticsearch-vagrant.git\n   ```\n3. Provision the Vagrant box (this install Elasticsearch and turns the box on)\n\n   ```\n   cd elasticsearch-vagrant\n   vagrant up --provision\n   ```\n4. Confirm Elasticsearch is running\n\n  ```\n  curl -XGET http://localhost:9200\n  ```\n  \n  or visit this URL in your browser. \n  \n  You should see JSON returned from the Elasticsearch instance. Something like:\n\n   ```json\n      {\n        \"name\" : \"Mary Zero\",\n        \"cluster_name\" : \"elasticsearch\",\n        \"version\" : {\n          \"number\" : \"2.0.0-rc1\",\n          \"build_hash\" : \"4757962b01a4d837af282f90df9e1fbdb68b524e\",\n          \"build_timestamp\" : \"2015-10-01T10:06:08Z\",\n          \"build_snapshot\" : false,\n          \"lucene_version\" : \"5.2.1\"\n        },\n        \"tagline\" : \"You Know, for Search\"\n      }\n   ```\n\n5. When you're done working with examples, turn off the Vagrant box\n\n  ```\n  vagrant halt\n  ```\n\n\n### Locally on Your Machine\n\nFollow [Elasticsearch's instructions](http://www.elastic.co/guide/en/elasticsearch/reference/1.5/_installation.html) to install Elasticsearch on your machine. \n\n## Running The Python Examples\n\nThe examples are written in Python 2.7 in [ipython notebooks](http://ipython.org/notebook.html) depending only on a few basic libraries. The only external library needed is the [requests](http://docs.python-requests.org/en/latest/) HTTP library. Some of the external APIs require API keys (for example TMDB, you can obtain one [here](https://www.themoviedb.org/faq/api)).\n\nTo run the IPython Notebook Examples\n\n1. First ensure you have git, python 2.7 and pip installed and in your PATH\n\n2. Then use the following commands to install the required dependencies\n  ```\n  git clone git@github.com:o19s/relevant-search-book.git\n  cd relevant-search-book\n  pip install requests\n  pip install jupyter\n  cd ipython/\n  ```\n\n5. Launch!\n\n  ```ipython notebook```\n\n6. Play!\n\nSwitch to your default browser where the Ipython examples are ready for you to experiment with. Keep in mind many examples are order dependent, so you can't just jump to an interesting listing and run it. Indexing commands with certain settings and what not need to be run. Be sure to run the prior ipython notebook commands too!\n\nHappy Searching!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fo19s%2Frelevant-search-book","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fo19s%2Frelevant-search-book","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fo19s%2Frelevant-search-book/lists"}