Home/Vector Databases/autonomous-hr-chatbot

autonomous-hr-chatbot

stepanogil/autonomous-hr-chatbot

Autonomous HR Chatbot using LangChain, OpenAI

GitHub Website

GraphCanon updated today · GitHub synced today

451

Stars

112

Forks

Open issues

Watchers

2mo

Last push

Python MITCreated Jun 15, 2023

Trust & integrity

Full report

Maintenance: Steady (73d since push); As of today · Source: github_public_v1
Provenance: Not a fork · Personal account; As of today · Source: github_public_v1
Security (OSV): 221 low (221 low); As of today · Source: osv@v1

Public GitHub metadata and optional OSV dependency scans. Signals, not a guarantee. Trust methodology.

Overview

An autonomous agent for answering HR queries using tools like embeddings in Pinecone, a calculator chain, and timekeeping policies document. Front-end powered by Streamlit.

Capability facts

Languages: python
Source: github.language · Jul 11, 2026

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

LangChain integrationLangChain

Source: README excerpt (regex_v1, Jul 11, 2026)

date:** A modernized version using an agent loop via OpenAI's Responses API (no LangChain, no Pinecone, with `gpt-5.2` reasoning summaries) lives in [`v2/`](./v2). The o

Source link

OpenAI APIOpenAI API

Source: README excerpt (regex_v1, Jul 11, 2026)

Run the notebook 'store_embeddings_in_pinecone.ipynb'. Replace the Pinecone and OpenAI API keys (for the embedding model) with your own.

Source link

Python runtimePython

Source: README excerpt (regex_v1, Jul 11, 2026)

1. Install python 3.10. [Windows](https://www.tomshardware.com/how-to/install-python-on-windows-10-and

Source link

Works with ChatGPTChatGPT

Source: README excerpt (regex_v1, Jul 11, 2026)

# Autonomous HR Chatbot built using ChatGPT, LangChain, Pinecone and Streamlit

Source link

README

✨ 2026 update: A modernized version using an agent loop via OpenAI's Responses API (no LangChain, no Pinecone, with gpt-5.2 reasoning summaries) lives in v2/. The original 2023 implementation below is preserved as a reference.

Autonomous HR Chatbot built using ChatGPT, LangChain, Pinecone and Streamlit

Companion Reading: Creating a (mostly) Autonomous HR Assistant with ChatGPT and LangChain’s Agents and Tools

TL;DR/Description

This is a prototype enterprise application - an autonomous agent that is able to answer HR queries using the tools it has on hand. It was made using LangChain's agents and tools modules, using Pinecone as vector database and powered by ChatGPT or gpt-3.5-turbo. The front-end is Streamlit using the streamlit_chat component.

Tools:

Timekeeping Policies - A ChatGPT generated sample HR policy document. Embeddings were created for this doc using OpenAI’s text-embedding-ada-002 model and stored in a Pinecone index.
Employee Data - A csv file containing dummy employee data (e.g. name, supervisor, # of leaves etc). It's loaded as a pandas dataframe and manipulated by the LLM using LangChain's PythonAstREPLTool
Calculator - this is LangChain's calculator chain module, LLMMathChain

Sample Chat

Sample Tool Use

How to use this repo

Install python 3.10. Windows, Mac
Clone the repo to a local directory.
Navigate to the local directory and run this command in your terminal to install all prerequisite modules - pip install -r requirements.txt
Input your own API keys in the hr_agent_backend_local.py file (or hr_agent_backend_azure.py if you want to use the azure version; just uncomment it in the frontend.py file)
Run streamlit run hr_agent_frontent.py in your terminal

Storing Embeddings in Pinecone

Create a Pinecone account in pinecone.io - there is a free tier. Take note of the Pinecone API and environment values.
Run the notebook 'store_embeddings_in_pinecone.ipynb'. Replace the Pinecone and OpenAI API keys (for the embedding model) with your own.

Tech Stack

Azure OpenAI Service - the OpenAI service offering for Azure customers.
LangChain - development frame work for building apps around LLMs.
Pinecone - the vector database for storing the embeddings.
Streamlit - used for the front end. Lightweight framework for deploying python web apps.
Azure Data Lake - for landing the employee data csv files. Any other cloud storage should work just as well (blob, S3 etc).
Azure Data Factory - used to create the data pipeline.
SAP HCM - the source system for employee data.