OctoBot: Octopus Energy Discord Bot

OctoBot is a Discord bot that integrates with the Octopus Energy API to provide users with their energy consumption data and costs directly within Discord. This bot allows users to set up their Octopus Energy accounts and retrieve detailed information about their electricity and gas usage.

Features

• Easy account setup through Discord commands or button interactions
• Retrieval of energy consumption data for electricity and gas
• Generation of consumption charts with improved visualizations using Seaborn
• Calculation of energy costs based on consumption and tariff data
• Support for different time periods (7, 30, or 90 days)
• Secure storage of user API keys and account numbers
• Improved error handling and data validation
• Caching system for better performance
• Detailed logging system
• Automatic timezone handling
• Retry mechanism for API requests
• Rate limiting and cooldown system

Prerequisites

• Python 3.8+
• Discord Bot Token
• Octopus Energy API access

Installation

1. Clone this repository:

   git clone https://github.com/Ropaxyz/OctoBot-Octopus-Energy-Discord-Bot.git
   cd OctoBot-Octopus-Energy-Discord-Bot
   

2. Install the required dependencies:

   pip install -r requirements.txt
   

3. Create a .env file in the root directory with the following variables:

   DISCORD_BOT_TOKEN=your_discord_bot_token_here
   DATABASE_URL=sqlite:///user_data.db
   SETUP_CHANNEL_ID=your_channel_id_here
   

Features and Improvements

New Features

• Improved error handling with detailed logging
• Data caching system using TTLCache
• Automatic retry mechanism for failed API requests
• Enhanced visualization using Seaborn
• Combined charts for electricity and gas data
• Better date handling with timezone support
• Input validation for API keys and account numbers
• Cooldown system for commands
• Improved setup process with validation
• Warning system for potentially incomplete data

Technical Improvements