Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bharathajjarapu/telehelp

Telegram Bot to help Emergencies
https://github.com/bharathajjarapu/telehelp

Last synced: 7 days ago
JSON representation

Telegram Bot to help Emergencies

Awesome Lists containing this project

README

        

# TeleHelp Emergency ChatBot 🆘

Welcome to the Emergency Helper ChatBot! This Python AI project is designed to assist users during emergencies by leveraging the power of GPT and local inference. With this chatbot, you can report accidents, fires, or crimes, and it will automatically dispatch the appropriate emergency services to your location. 💻🚑🚒🚓

## Features ✨

- 💬 Natural language processing using GPT-4 for understanding user inputs
- 📍 Location sharing for accurate emergency response
- 🔍 Smart incident detection and categorization (accidents, fires, crimes)
- 🚑 Automated ambulance dispatch for medical emergencies
- 🚒 Fire brigade notification for fire-related incidents
- 🚓 Police dispatch for reported crimes
- 🌐 Local inference for privacy and data protection

## Getting Started 🚀

To get started with the Emergency Helper ChatBot, follow these steps:

1. **Clone the Repository**

```bash
git clone https://github.com/your-username/Emergency-Helper-ChatBot.git
cd Emergency-Helper-ChatBot
```

2. **Install Dependencies**

```bash
pip install -r requirements.txt
```

3. **Set Up Local Inference Server**

This project utilizes a local inference server for GPT-4. Follow the instructions in the [Local Inference Server Setup Guide](link-to-setup-guide) to set up the server.

4. **Configure Telegram Bot**

Obtain a Telegram Bot API token from the [@BotFather](https://t.me/BotFather) and replace the placeholder token in `app.py`.

5. **Run the Application**

```bash
python app.py
```

Now, you can interact with the Emergency Helper ChatBot through your Telegram app!

## Usage Examples 📚

- 🚗 "I have been in a car accident."
- 🔥 "There is a fire in my neighborhood."
- 🔫 "I witnessed a robbery."

The chatbot will ask for your location and dispatch the appropriate emergency services based on the situation.

## Contributing 🤝

We welcome contributions to improve the Emergency Helper ChatBot! If you have any ideas, bug fixes, or new features, please submit a pull request or create an issue in the repository.

## License 📄

This project is licensed under the [MIT License](link-to-license).

## Acknowledgments 🙏

- [OpenAI](https://openai.com/) for their powerful GPT models
- [Python-Telegram-Bot](https://python-telegram-bot.org/) for the Telegram bot library
- [OpenAI Python Library](https://github.com/openai/openai-python) for the local inference integration

Stay safe, and let the Emergency Helper ChatBot be your guardian in times of need! 🛡️