Kahlan Amnell Discord Bot

Kahlan Amnell is a Discord bot built in Python to automate and ease access to information for students and travelers. It provides a user-friendly interface and advanced commands designed for a broad audience.

---

Table of Contents

• Introduction
• Main Features
• Installation
• Configuration & Setup
• Usage
• Support
• Technologies
• License

---

Introduction

Born from a passion for Discord automation and Python, this bot was initially a personal project and now offers rich, adaptable features for everyone. Its core purpose is to quickly fetch schedules and details for transit and university life.

---

Main Features

• Valenciennes Tram Schedules
  Query real-time tram schedules for Valenciennes using the /transville command. Receive departure and arrival times, smart suggestions, and tailored results[file:1].

• SNCF Train Availability, Fares, and Timetables
  Check French train availability, schedules, and prices with /sncf. Results are presented with clear visuals and embeds for easy reading[file:1].

• UPHF Student Timetables
  Instantly retrieve your Université Polytechnique des Hauts de France schedule (or any registered student’s) with /sesame edt. Filter by day or week as needed[file:1].

---

Installation

1. Clone the repository:

git clone https://github.com/HANTALE-59/Kahlan-amnell-discord-bot.git
cd Kahlan-amnell-discord-bot

Install dependencies:

python -m pip install -r requirements.txt

---

Configuration & Setup

• Create a config.json file, specifying your prefix, invite link, and Discord credentials.
• Add your Discord bot token in a .env file as TOKEN=your_token_here.
• Start the bot:python bot.py

---

Usage

• /transville: Get real-time Valenciennes tram schedules
• /sncf: Find train times, fares, and seat availability (SNCF)
• /sesame edt: Fetch your UPHF student timetable
• More commands and customization are available via /help on Discord.

---

Support

Need help or want to contribute?

• Join the Discord server: Invite link
• Open an issue on GitHub

---

Technologies

• Python 3.12+
• discord.py
• requests, BeautifulSoup4
• PIL (Pillow)
• Integrated SQLite database

---

License

This project is licensed under the Apache 2.0 License. Please retain original credits and abide by the terms of use. Simple based template: https://github.com/kkrypt0nn/Python-Discord-Bot-Template/blob/master/LICENSE.md