PDL_QUERY / README.md
adityapatkar's picture
Small update
67f6efa
---
title: PDL QUERY
emoji: πŸ“ˆ
colorFrom: green
colorTo: green
sdk: streamlit
sdk_version: 1.21.0
app_file: app.py
pinned: false
---
# People Data Labs Query Tool with Streamlit
## Overview
This is a web application built with Streamlit that allows you to search for a person or company using the People Data Labs API. You can perform searches by providing the necessary parameters, such as your API key, the type of search (person or company), an SQL query, the dataset to search in, the number of results to return, and whether you want the results to be pretty printed.
## Guidelines
To use the People Data Labs Query Tool, follow the guidelines below:
- **API Key**: You will need to obtain an API key from People Data Labs. If you don't have one, visit their website to get your API key.
- **Type**: Specify whether you want to search for a person or a company. You can select either option from the dropdown menu.
- **SQL Query**: Provide the SQL query you want to run. You can find this query on the dashboard provided by People Data Labs.
- **Dataset**: If you want to narrow down your search to a specific dataset, you can enter the dataset name. Leaving this field blank will search across all datasets.
- **Size**: Specify the number of results you want to return. The tool will return the specified number of results based on your query.
- **Pretty Print**: By default, the results are not pretty printed. If you prefer the results to be displayed in a more readable format, you can enable this option.
## Installation and Local Setup
Follow the steps below to install and run the People Data Labs Query Tool locally:
1. Clone the repository to your local machine:
```bash
git clone https://github.com/your_username/your_repo.git
```
2. Navigate to the project directory:
```bash
cd your_repo
```
3. Create a virtual environment (optional, but recommended):
```bash
python3 -m venv venv
```
4. Activate the virtual environment:
```bash
source venv/bin/activate
```
5. Install the required dependencies from `requirements.txt`:
```bash
pip install -r requirements.txt
```
## Running the Application
Once you have completed the installation and local setup, you can run the People Data Labs Query Tool:
```bash
streamlit run app.py
```
After executing the command above, Streamlit will launch a local development server and display a URL (usually http://localhost:8501) where you can access the web application in your browser.
## Note
Please remember to keep your API key secure and do not share it publicly or commit it to version control systems.
Happy searching with the People Data Labs Query Tool!
## Resources
The app is built with [Streamlit](https://streamlit.io/), a Python library that makes it easy to build web applications for machine learning and data science.
The app is also deployed on huggingface spaces. You can access the app [here](https://huggingface.co/spaces/adityapatkar/PDL_QUERY).