Mensa: Your Personalized Q & A bot for Menstrual Health

Mensa is an intelligent Q&A bot designed to provide comprehensive information and support regarding female menstrual health. Powered by Langchain & Mistral AI technologies, Mensa leverages Wikipedia, PubMed, and Tavily Search APIs to deliver accurate and detailed responses to user queries.

Features

• Personalized Responses: Mensa provides tailored responses to questions related to menstrual health, including periods, symptoms, solutions, diseases, and myths.
• Multi-Source Integration: Utilizes Wikipedia, PubMed, and Tavily Search APIs to gather relevant information from credible sources.
• Strict Information Policy: Ensures that only verified sources are used for information retrieval, maintaining accuracy and reliability.
• User-Friendly Interface: Simple and intuitive interface for users to ask questions and receive prompt responses.

How to Use

1. Ask Questions: Enter your queries about menstrual health in the text input field.
2. Receive Answers: Mensa will provide detailed responses sourced from Wikipedia and PubMed, ensuring accurate information.
3. Explore Topics: Browse through various topics related to menstrual health and discover valuable insights.

Technologies Used

• Langchain Community: Utilizes Langchain Community Framework tools for seamless integration with Wikipedia and PubMed APIs.
• Mistral AI: Employs Mistral AI's (Mixtral-8x7B-Instruct) model hosted by Fireworks AI for generating accurate and informative responses.
• Streamlit: Frontend interface built using Streamlit for a user-friendly experience.

Get Started

To start using Mensa and explore the world of menstrual health, simply click here.

How to Run Locally

To run Mensa locally on your machine, follow these steps:

Prerequisites

1. Python: Ensure you have Python installed on your system. You can download it from the official Python website.

2. Virtual Environment (Optional): It's recommended to use a virtual environment to manage dependencies. You can create one using virtualenv or venv.

Installation

1. Clone the Repository: Clone the Mensa repository to your local machine using the following command:

   git clone https://github.com/sagnik-datta-02/Mensa

2. Navigate to the Directory: Move into the Mensa directory:

   cd mensa

3. Install Dependencies: Install the required Python packages using pip:

   pip install -r requirements.txt

Configuration

1. Environment Variables: Create a .env file in the root directory and add the necessary environment variables. You can refer to the .env.example file for the required variables.

Running the Application

Once you've installed the dependencies and configured the environment variables, you can run Mensa locally:

streamlit run mensa.py

The application will start running, and you can access it in your web browser by navigating to http://localhost:8501.

Usage

1. Ask Questions: Enter your queries about menstrual health in the provided text input field.
2. Receive Answers: Mensa will provide detailed responses sourced from Wikipedia and PubMed.
3. Explore Topics: Browse through various topics related to menstrual health and discover valuable insights.

Contributing

Contributions to Mensa are welcome! If you'd like to contribute, fork the repository, make your changes, and submit a pull request.

Now you're all set to run Mensa locally on your machine and explore the world of menstrual health! If you encounter any issues or have questions, feel free to reach out to the project maintainers.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---