adding CLI added webui to allow users to manage via UI also

Author: lewispour

README.md

@@ -44,8 +44,9 @@ This Python-based Twitter Auto-Post Bot automates tweeting, Credit to the Tweepy
 - `src/functions.py`: Shared functions for generating tweets from openai and tweet posting
 - `requirements.txt`: Lists all necessary Python packages.
 
-### 📁 Upcoming Features
-- `Adding CLI`.
+### ⭐ New: Command Line Interface (CLI)
+
+The bot now includes a powerful CLI for easy management! See the [CLI Usage](#-cli-usage) section below.
 
 ## 🚀 Getting Started
 
@@ -81,13 +82,153 @@ This Python-based Twitter Auto-Post Bot automates tweeting, Credit to the Tweepy
 
 ## 🔧 Usage
 
+### Option 1: Using the Web UI (Recommended)
+
+The easiest way to use the bot is through the browser-based web interface. See the [Web UI Usage](#-web-ui-usage) section below.
+
+### Option 2: Using the CLI
+
+For command-line enthusiasts, see the [CLI Usage](#-cli-usage) section below for terminal-based commands.
+
+### Option 3: Running Scripts Directly
+
 Run any script using Python:
 
 ```bash
 cd src/
 python instantly-tweet-from-openai.py
 ```
 
+## 🌐 Web UI Usage
+
+The Web UI provides the easiest way to manage your Twitter bot through your browser.
+
+### Starting the Web Interface
+
+After installing dependencies with `pip install -r requirements.txt`, start the web server:
+
+```bash
+python web.py
+```
+
+The web interface will be available at: **http://localhost:5000**
+
+Your browser should automatically open, or you can manually navigate to the URL.
+
+### Web UI Features
+
+#### Dashboard
+- View bot status and scheduler state
+- Test Twitter API credentials
+- Quick access to all features
+- Monitor scheduled jobs
+
+#### Post Tweet
+- **AI-Generated Tweets**: Generate tweets using OpenAI's GPT-4 with custom prompts
+- **Random from File**: Post a random tweet from your tweets.txt library
+- **Custom Tweet**: Write and post your own tweet with character counter
+
+#### Manage Tweets
+- View all tweets in your library
+- Add new tweets to the library
+- Edit existing tweets inline
+- Delete unwanted tweets
+- See library statistics
+
+#### Schedule
+- Schedule daily AI-generated tweets at specific times
+- Schedule daily posts from your tweet library
+- Monitor scheduler status in real-time
+- Start/stop the scheduler
+- View active scheduled jobs
+
+### Web UI Tips
+
+- The web server must remain running for scheduled tweets to work
+- All times are in 24-hour format (HH:MM)
+- Only one scheduler can run at a time
+- The interface auto-refreshes scheduler status every 10 seconds
+
+## 🎯 CLI Usage
+
+The CLI provides a simple and intuitive interface for all bot operations.
+
+### Installation
+
+After installing dependencies with `pip install -r requirements.txt`, you can run the CLI:
+
+```bash
+python cli.py --help
+```
+
+### Available Commands
+
+#### 1. Test Credentials
+
+Test your Twitter API credentials:
+
+```bash
+python cli.py test
+```
+
+#### 2. Post a Tweet Instantly
+
+**Post with AI (OpenAI):**
+```bash
+python cli.py post --ai
+```
+
+**Post with custom AI prompt:**
+```bash
+python cli.py post --ai --prompt "Create a tweet about Python programming"
+```
+
+**Post random tweet from file:**
+```bash
+python cli.py post --file
+```
+
+**Post custom text:**
+```bash
+python cli.py post --text "Hello Twitter! This is my custom tweet"
+```
+
+#### 3. Schedule Daily Tweets
+
+**Schedule AI-generated tweets:**
+```bash
+python cli.py schedule-posts --ai --time "09:00"
+```
+
+**Schedule with custom prompt:**
+```bash
+python cli.py schedule-posts --ai --time "14:30" --prompt "Create a tweet about technology"
+```
+
+**Schedule tweets from file:**
+```bash
+python cli.py schedule-posts --file --time "12:00"
+```
+
+#### 4. Manage Tweets File
+
+**List all tweets in file:**
+```bash
+python cli.py list-tweets
+```
+
+**Add a new tweet to file:**
+```bash
+python cli.py add-tweet
+```
+
+### CLI Tips
+
+- All times are in 24-hour format (HH:MM)
+- Press `Ctrl+C` to stop the scheduler
+- The `--help` flag works with any command for more details
+- Example: `python cli.py post --help`
+
 ## 🤝 Contributing
 
 Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

cli.py

@@ -0,0 +1,225 @@
+#!/usr/bin/env python3
+"""
+Twitter Auto-Post Bot CLI
+A command-line interface for managing automated Twitter posts.
+"""
+
+import click
+import sys
+import os
+import schedule
+import time
+import random
+
+sys.path.append(os.path.join(os.path.dirname(__file__), 'config'))
+sys.path.append(os.path.join(os.path.dirname(__file__), 'src'))
+
+import keys
+from src.functions import generate_response, initialize_tweepy, get_formatted_date
+
+
+@click.group()
+@click.version_option(version='1.0.0')
+def cli():
+    """Twitter Auto-Post Bot - Automate your Twitter presence."""
+    pass
+
+
+@cli.command()
+@click.option('--ai', is_flag=True, help='Generate tweet using AI')
+@click.option('--file', 'from_file', is_flag=True, help='Post random tweet from file')
+@click.option('--text', help='Post custom text')
+@click.option('--prompt', default='Create a short tweet about Motorbikes.', help='Custom prompt for AI (only with --ai)')
+def post(ai, from_file, text, prompt):
+    """Post a tweet instantly."""
+
+    if sum([ai, from_file, bool(text)]) != 1:
+        click.echo(click.style('Error: Please specify exactly one option: --ai, --file, or --text', fg='red'))
+        sys.exit(1)
+
+    try:
+        client, _ = initialize_tweepy()
+
+        if ai:
+            click.echo(click.style(f'Generating tweet with AI...', fg='yellow'))
+            click.echo(click.style(f'Prompt: {prompt}', fg='cyan'))
+            response = generate_response(prompt)
+            tweet_text = response
+            click.echo(click.style(f'\nGenerated tweet: {tweet_text}', fg='green'))
+
+        elif from_file:
+            tweets_file = os.path.join(os.path.dirname(__file__), 'data', 'tweets.txt')
+            if not os.path.exists(tweets_file):
+                click.echo(click.style(f'Error: tweets.txt not found at {tweets_file}', fg='red'))
+                sys.exit(1)
+
+            with open(tweets_file, 'r') as file:
+                lines = [line.strip() for line in file.readlines() if line.strip()]
+
+            if not lines:
+                click.echo(click.style('Error: tweets.txt is empty', fg='red'))
+                sys.exit(1)
+
+            tweet_text = random.choice(lines)
+            click.echo(click.style(f'Selected tweet: {tweet_text}', fg='green'))
+
+        else:
+            tweet_text = text
+            click.echo(click.style(f'Posting: {tweet_text}', fg='green'))
+
+        client.create_tweet(text=tweet_text)
+        click.echo(click.style('Tweet posted successfully!', fg='green', bold=True))
+
+    except Exception as e:
+        click.echo(click.style(f'Error posting tweet: {str(e)}', fg='red'))
+        sys.exit(1)
+
+
+@cli.command()
+@click.option('--ai', is_flag=True, help='Schedule AI-generated tweets')
+@click.option('--file', 'from_file', is_flag=True, help='Schedule tweets from file')
+@click.option('--time', 'schedule_time', default='09:00', help='Time to post daily (HH:MM format, default: 09:00)')
+@click.option('--prompt', default='Create a short tweet about Motorbikes.', help='Custom prompt for AI (only with --ai)')
+def schedule_posts(ai, from_file, schedule_time, prompt):
+    """Schedule daily tweets at a specific time."""
+
+    if not ai and not from_file:
+        click.echo(click.style('Error: Please specify either --ai or --file', fg='red'))
+        sys.exit(1)
+
+    if ai and from_file:
+        click.echo(click.style('Error: Please specify only one option: --ai or --file', fg='red'))
+        sys.exit(1)
+
+    try:
+        client, _ = initialize_tweepy()
+
+        if ai:
+            def send_ai_post():
+                try:
+                    click.echo(click.style(f'\nGenerating and posting tweet...', fg='yellow'))
+                    response = generate_response(prompt)
+                    client.create_tweet(text=response)
+                    click.echo(click.style(f'Tweet posted: {response}', fg='green'))
+                    click.echo(click.style(f'Next post scheduled for tomorrow at {schedule_time}', fg='cyan'))
+                except Exception as e:
+                    click.echo(click.style(f'Error posting tweet: {str(e)}', fg='red'))
+
+            schedule.every().day.at(schedule_time).do(send_ai_post)
+            click.echo(click.style(f'Scheduled AI-generated tweets daily at {schedule_time}', fg='green', bold=True))
+            click.echo(click.style(f'Prompt: {prompt}', fg='cyan'))
+
+        else:
+            tweets_file = os.path.join(os.path.dirname(__file__), 'data', 'tweets.txt')
+            if not os.path.exists(tweets_file):
+                click.echo(click.style(f'Error: tweets.txt not found at {tweets_file}', fg='red'))
+                sys.exit(1)
+
+            def send_file_post():
+                try:
+                    with open(tweets_file, 'r') as file:
+                        lines = [line.strip() for line in file.readlines() if line.strip()]
+
+                    if not lines:
+                        click.echo(click.style('Error: tweets.txt is empty', fg='red'))
+                        return
+
+                    tweet_text = random.choice(lines)
+                    client.create_tweet(text=tweet_text)
+                    click.echo(click.style(f'\nTweet posted: {tweet_text}', fg='green'))
+                    click.echo(click.style(f'Next post scheduled for tomorrow at {schedule_time}', fg='cyan'))
+                except Exception as e:
+                    click.echo(click.style(f'Error posting tweet: {str(e)}', fg='red'))
+
+            schedule.every().day.at(schedule_time).do(send_file_post)
+            click.echo(click.style(f'Scheduled tweets from file daily at {schedule_time}', fg='green', bold=True))
+
+        click.echo(click.style('\nPress Ctrl+C to stop the scheduler', fg='yellow'))
+
+        while True:
+            schedule.run_pending()
+            time.sleep(60)
+
+    except KeyboardInterrupt:
+        click.echo(click.style('\n\nScheduler stopped.', fg='yellow'))
+    except Exception as e:
+        click.echo(click.style(f'Error: {str(e)}', fg='red'))
+        sys.exit(1)
+
+
+@cli.command()
+def test():
+    """Test Twitter API credentials."""
+    try:
+        click.echo(click.style('Testing Twitter API credentials...', fg='yellow'))
+        client, api = initialize_tweepy()
+
+        user = api.verify_credentials()
+        click.echo(click.style('\nCredentials verified successfully!', fg='green', bold=True))
+        click.echo(click.style(f'Authenticated as: @{user.screen_name}', fg='cyan'))
+        click.echo(click.style(f'Name: {user.name}', fg='cyan'))
+        click.echo(click.style(f'Followers: {user.followers_count}', fg='cyan'))
+        click.echo(click.style(f'Following: {user.friends_count}', fg='cyan'))
+
+    except Exception as e:
+        click.echo(click.style(f'\nCredentials test failed: {str(e)}', fg='red'))
+        click.echo(click.style('\nPlease check your credentials in config/keys.py', fg='yellow'))
+        sys.exit(1)
+
+
+@cli.command()
+def list_tweets():
+    """List all tweets from the tweets.txt file."""
+    tweets_file = os.path.join(os.path.dirname(__file__), 'data', 'tweets.txt')
+
+    if not os.path.exists(tweets_file):
+        click.echo(click.style(f'Error: tweets.txt not found at {tweets_file}', fg='red'))
+        sys.exit(1)
+
+    try:
+        with open(tweets_file, 'r') as file:
+            lines = [line.strip() for line in file.readlines() if line.strip()]
+
+        if not lines:
+            click.echo(click.style('tweets.txt is empty. Add some tweets first!', fg='yellow'))
+            return
+
+        click.echo(click.style(f'\nFound {len(lines)} tweet(s) in file:', fg='green', bold=True))
+        click.echo()
+
+        for i, tweet in enumerate(lines, 1):
+            click.echo(click.style(f'{i}. ', fg='cyan') + tweet)
+
+    except Exception as e:
+        click.echo(click.style(f'Error reading tweets file: {str(e)}', fg='red'))
+        sys.exit(1)
+
+
+@cli.command()
+def add_tweet():
+    """Add a new tweet to the tweets.txt file interactively."""
+    tweets_file = os.path.join(os.path.dirname(__file__), 'data', 'tweets.txt')
+
+    os.makedirs(os.path.dirname(tweets_file), exist_ok=True)
+
+    tweet = click.prompt(click.style('Enter your tweet', fg='cyan'))
+
+    if len(tweet) > 280:
+        click.echo(click.style(f'Warning: Tweet is {len(tweet)} characters (Twitter limit is 280)', fg='yellow'))
+        if not click.confirm(click.style('Do you want to add it anyway?', fg='yellow')):
+            click.echo(click.style('Tweet not added.', fg='red'))
+            return
+
+    try:
+        with open(tweets_file, 'a') as file:
+            file.write(tweet + '\n')
+
+        click.echo(click.style('\nTweet added successfully!', fg='green', bold=True))
+
+    except Exception as e:
+        click.echo(click.style(f'Error adding tweet: {str(e)}', fg='red'))
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    cli()

data/tweets.txt

@@ -1,3 +1,3 @@
-Here is a tweet
+Here is a tweet 1
 here is a different tweet
 tweeet tweeet blah blah