README.md

Variable Search

A hybrid lexical & semantic search system for survey items.

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. License
5. Contact

About The Project

This project implements a multilingual, hybrid lexical & semantic search system for over 80,000 survey items (i.e., variables) from surveys such as Eurobarometer, ISSP, EVS, and more.

Getting Started

After installing dependencies and running the web app, you can immediately use it by navigating to http://localhost:8000.

Prerequisites

• Install python
• Install JDK

Installation

1. Clone the repo

   git clone https://github.com/vadis-project/variable-search-demo.git

2. Create and activate a virtual environment

   python3 -m venv venv
   source /venv/bin/activate

3. Install python packages

   pip install -r requirements.txt

Usage

Run the application on a specified port (e.g., port 8000) and navigate to http://localhost:8000:

  streamlit run app.py --server.port 8080

You can configure additional settings in config.py.

License

MIT license. See LICENSE for more information.

Contact

Tornike Tsereteli - [email protected]