Skip to content

codeforpakistan/Numainda

Repository files navigation

Numainda - The Legal and Parliamentary Facts Knowledge Bot

Numainda Logo

Project Overview

Numainda is a Knowledge bot designed to engage and educate on Pakistan's rich legal and parliamentary heritage. Drawing on the Constitution of Pakistan, the Elections Act 2017, and the latest parliamentary proceedings, Numainda shares fascinating legal and legislative facts in a fun, engaging manner. Our mission is to demystify Pakistan's legal documents and parliamentary proceedings, making them accessible and enjoyable.

Features

  • Daily Tweets: Numainda posts daily tweets that are concise, fact-filled, and engaging, using simple language and emojis to enhance readability. (Coming Soon)
  • Engagement with Questions: The bot provides knowledgeable yet entertaining responses to questions about its knowledge base.
  • Bulletin Updates: Shares insights into the latest debates, policies, and discussions directly from the heart of Pakistan's Parliament.
  • Chat UI: A user-friendly chat interface that allows users to interact with the bot, ask questions, and receive informative responses.

Prerequisites

  • Python 3.9 or newer
  • Twitter Developer Account and access to the Twitter v2 API (Coming Soon)
  • OpenAI API key for using GPT models

Setup

  1. Clone the repository:

    git clone https://github.com/yourgithubusername/numainda.git
    cd numainda
  2. Install dependencies:

    pip install -r requirements.txt
  3. Configure environment variables:

    Create a .env file in the project root and add your Twitter and OpenAI API keys:

    TWITTER_CONSUMER_KEY=your_twitter_consumer_key
    TWITTER_CONSUMER_SECRET=your_twitter_consumer_secret
    TWITTER_ACCESS_TOKEN=your_access_token
    TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret
    OPENAI_API_KEY=your_openai_api_key
    

    Create a .streamlit/secrets.toml file:

    ASSISTANT_ID="<assistant-id>"
    OPEN_AI_API_KEY="<api-key>"
    

Usage

To run Numainda streamlit, execute:

streamlit run st_numainda.py

This script initiates the bot, allowing it to start tweeting and responding to queries.

Contributing

We welcome contributions! If you have suggestions for new features, improvements, or bug fixes, feel free to:

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/your_feature_name)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin feature/your_feature_name)
  5. Open a new Pull Request

License

This project is licensed under the MIT License.

About

Numainda a democracy focused knowledge bot

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages