{"id":24973001,"url":"https://github.com/weaviate-tutorials/demo-text-search-wines","last_synced_at":"2025-04-11T07:48:57.597Z","repository":{"id":196854634,"uuid":"696276268","full_name":"weaviate-tutorials/DEMO-text-search-wines","owner":"weaviate-tutorials","description":null,"archived":false,"fork":false,"pushed_at":"2024-03-18T00:25:24.000Z","size":809,"stargazers_count":3,"open_issues_count":1,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T05:27:18.739Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"Python","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/weaviate-tutorials.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-25T12:45:26.000Z","updated_at":"2024-05-24T07:46:16.000Z","dependencies_parsed_at":"2023-09-30T22:49:04.520Z","dependency_job_id":"adaf4989-b0a4-4367-99a0-aaa6d9cad5f2","html_url":"https://github.com/weaviate-tutorials/DEMO-text-search-wines","commit_stats":null,"previous_names":["weaviate-tutorials/demo-text-search-wines"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaviate-tutorials%2FDEMO-text-search-wines","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaviate-tutorials%2FDEMO-text-search-wines/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaviate-tutorials%2FDEMO-text-search-wines/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaviate-tutorials%2FDEMO-text-search-wines/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/weaviate-tutorials","download_url":"https://codeload.github.com/weaviate-tutorials/DEMO-text-search-wines/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248359645,"owners_count":21090562,"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":["hacktoberfest"],"created_at":"2025-02-03T18:11:17.880Z","updated_at":"2025-04-11T07:48:57.578Z","avatar_url":"https://github.com/weaviate-tutorials.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Semantic search of wines\n\nIn this repository, you'll find the practical essence of the article [Hackernoon article: \"Semantic Search Queries Return More Informed Results\"](https://hackernoon.com/semantic-search-queries-return-more-informed-results-nr5335nw) distilled into code (albeit updated). The author points out a common hurdle: the struggle with searching through our own unstructured data. Weaviate, an open-source vector search engine, is introduced as a sturdy bridge over this hurdle. Following the narrative, this codebase sets up Weaviate, harnesses the open transformer model [`sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2`](https://huggingface.co/sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2) for vectorization through the [vectorization module](https://www.semi.technology/developers/weaviate/current/modules/text2vec-transformers.html), and dives into a dataset of wine reviews. This repository demonstrates how to set up Weaviate with your data and get straight to firing up search queries. \n\n(TODO: Add demo video)\n\n## Prerequisites\nBefore you can run the project, you need to have Docker, Docker Compose, and Python installed on your machine. Follow the instructions below to install the prerequisites:\n\n### 1. Install Docker:\n   - **For Windows and Mac**:\n      - Download and install Docker Desktop from [Docker's official website](https://www.docker.com/products/docker-desktop).\n   - **For Linux**:\n      - Run the following commands in your terminal:\n        ```bash\n        sudo apt-get update\n        sudo apt-get install docker-ce docker-ce-cli containerd.io\n        ```\n\n### 2. Install Docker Compose:\n   - **For Windows and Mac**:\n      - Docker Compose is included with Docker Desktop.\n   - **For Linux**:\n      - Run the following command in your terminal:\n        ```bash\n        sudo apt install docker-compose\n        ```\n\n### 3. Install Python:\n   - Download and install the latest version of Python from [Python's official website](https://www.python.org/downloads/).\n   - Verify the installation by running the following command in your terminal:\n     ```bash\n     python --version\n     ```\n\n## Setup instructions\n1. **Install virtualenv** (if not already installed):\n   ```bash\n   pip install virtualenv\n   ```\n2. **Create a Virtual Environment:** \n   Navigate to the directory where you want to create your virtual environment, then run:\n   ```bash\n   virtualenv \u003cname_of_virtualenv\u003e\n   ```\n3. **Activate the Virtual Environment:** \n   On Windows, run:\n   ```bash\n   .\\\u003cname_of_virtualenv\u003e\\Scripts\\activate\n   ```\n   On macOS and Linux, run:\n   ```bash\n   source \u003cname_of_virtualenv\u003e/bin/activate\n   ```\n4. **Install Python requirements:**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n## Usage instructions\n1. Start up Weaviate: `docker-compose up -d`. Once completed, Weaviate is running on [`http://localhost:8080`]().\n2. Run `python import.py` to import 2500 wines to Weaviate.\n3. The data is now stored in the Weaviate instance. You can experiment with it using a python notebook or a python file.\n\n## Dataset license\nThis folder contains Wine review data, retrieved from [Kaggle (from WineEnthusiast)](https://www.kaggle.com/zynicide/wine-reviews).\n\n## Notes:\nThis project's origin is [here](https://github.com/weaviate/weaviate-examples/tree/main/semanticsearch-transformers-wines) and the [Hackernoon article: \"Semantic Search Queries Return More Informed Results\"](https://hackernoon.com/semantic-search-queries-return-more-informed-results-nr5335nw).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweaviate-tutorials%2Fdemo-text-search-wines","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweaviate-tutorials%2Fdemo-text-search-wines","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweaviate-tutorials%2Fdemo-text-search-wines/lists"}