Git Product home page Git Product logo

mensa's Introduction

Mensa: Your Personalized Q & A bot for Menstrual Health

Mensa Logo

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.


mensa's People

Contributors

sagnik-datta-02 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.