Installation Guide

Get AUTO-blogger up and running in minutes with our comprehensive installation guide.

One-Command Setup

Get AUTO-blogger running in minutes with our intelligent installation script that automatically detects your operating system and handles everything for you.

Linux Terminal 
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash

Supports:

  • Ubuntu 18.04+ / Debian 10+
  • CentOS 7+ / RHEL 7+ / Fedora 30+
  • Arch Linux / Manjaro
  • openSUSE Leap 15+
macOS Terminal 
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash

Supports:

  • macOS 10.14+ (Mojave and later)
  • Intel and Apple Silicon (M1/M2) Macs
  • Automatic Homebrew installation
  • Native .app bundle creation
Windows PowerShell/WSL 
# Option 1: Windows Subsystem for Linux (Recommended)
wsl curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash

# Option 2: Git Bash
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash

Supports:

  • Windows 10/11 with WSL2
  • Git Bash environment
  • Native Windows batch files
  • PowerShell integration

Smart Installation Helper

Download ready-to-run installation scripts tailored for your operating system with step-by-step guidance.

Downloads ready-to-run installation scripts for your operating system with detailed instructions
What this intelligent script does:
  • 🔍 Smart OS Detection: Automatically identifies your operating system and architecture
  • Dependency Management: Installs Git, Python 3.8+, and Chrome/Chromium using your system's package manager
  • Environment Setup: Creates an isolated Python virtual environment with all required packages
  • Launcher Creation: Sets up system-wide autoblog command and desktop shortcuts
  • Verification: Tests the installation and provides detailed success/error reporting
  • Auto-Update: Configures automatic updates from the GitHub repository

Advanced Installation Options

Customize your AUTO-blogger installation with these advanced configuration options for specific deployment scenarios.

Non-Interactive Mode

CI/CD

Perfect for automated deployments, Docker containers, and CI/CD pipelines. Skips all user prompts and uses default configurations.

Automated Deployment 
export NON_INTERACTIVE=true
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash
  • No user prompts
  • Default configurations
  • Docker-friendly

Force Update Mode

UPDATE

Automatically update existing installations without confirmation. Preserves user configurations while updating core components.

Force Update 
export AUTO_UPDATE=true
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash
  • Preserves configurations
  • Updates dependencies
  • No confirmation prompts

Custom Installation Directory

CUSTOM

Install AUTO-blogger to a specific location on your system. Useful for shared systems or custom deployment structures.

Custom Directory 
export INSTALL_DIR="/opt/autoblogger"
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash
  • Custom path support
  • Multi-user friendly
  • Organized deployment

Development Mode

DEV

Install the latest development version with debug features enabled. Perfect for contributors and testers.

Development Install 
export INSTALL_BRANCH="develop"
export DEBUG_MODE=true
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash
  • Latest features
  • Debug logging
  • Development tools

Offline Installation

OFFLINE

Install from a pre-downloaded package for air-gapped systems or limited internet connectivity environments.

Offline Install 
# Download package first
wget https://github.com/AryanVBW/AUTO-blogger/releases/latest/download/autoblogger-offline.tar.gz

# Extract and install
tar -xzf autoblogger-offline.tar.gz
cd autoblogger-offline && ./install.sh
  • No internet required
  • Pre-bundled dependencies
  • Air-gapped compatible

Minimal Installation

MINIMAL

Install only core components without optional features. Reduces disk usage and installation time.

Minimal Install 
export MINIMAL_INSTALL=true
export SKIP_OPTIONAL=true
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash
  • Smaller footprint
  • Faster installation
  • Core features only

Combined Configuration Examples

🐳 Docker Deployment
export NON_INTERACTIVE=true
export INSTALL_DIR="/app/autoblogger"
export MINIMAL_INSTALL=true
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash
🔄 CI/CD Pipeline
export NON_INTERACTIVE=true
export AUTO_UPDATE=true
export DEBUG_MODE=false
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash
🖥️ Server Deployment
export INSTALL_DIR="/opt/autoblogger"
export NON_INTERACTIVE=true
export SKIP_DESKTOP_SHORTCUTS=true
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash

Installation Tips

Environment Variables

All options can be combined and set before running the installation script.

Security

Always verify the script source and use HTTPS URLs for secure downloads.

Logging

Set DEBUG_MODE=true to enable detailed installation logging.

Recovery

Failed installations can be resumed by re-running the same command.

System Requirements

🐍 Python

Version: 3.8 or higher

Required packages: pip, venv

🌐 Web Browser

Supported: Chrome, Chromium

Purpose: Web automation and scraping

🔗 Git

Purpose: Repository cloning and updates

Auto-install: Yes (if missing)

💾 Storage

Required: ~500MB free space

Includes: Dependencies and cache

🖥️ Supported Operating Systems

Linux
Linux

Ubuntu, Debian, CentOS, Fedora, Arch Linux

macOS
macOS

macOS 10.14+ (Mojave and later)

Windows
Windows

Windows 10/11 with WSL or native support

🤖 Automated Installation

Standard Installation

Standard Install 
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash

Non-Interactive Installation

For automated deployments or CI/CD environments:

Non-Interactive Install 
export NON_INTERACTIVE=true
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash

Auto-Update Mode

Automatically update existing installations:

Auto-Update 
export AUTO_UPDATE=true
curl -fsSL https://raw.githubusercontent.com/AryanVBW/AUTO-blogger/main/install_autoblog.sh | bash

Installation Process

1

System Verification

Checks OS compatibility, internet connection, and disk space

2

Installation Check

Detects existing installations and offers update options

3

Git Setup

Installs Git if missing and configures repository access

4

Repository Setup

Clones or updates the AUTO-blogger repository

5

Python Setup

Verifies Python 3.8+ installation and pip availability

6

Browser Setup

Installs Chrome/Chromium for web automation

7

Virtual Environment

Creates isolated Python environment for dependencies

8

Dependencies Installation

Installs all required Python packages from requirements.txt

9

Launcher Creation

Creates system launchers and desktop shortcuts

10

Testing Installation

Verifies all components and provides usage instructions

Manual Installation Guide

Complete step-by-step manual installation for all operating systems. Choose your platform below:

Linux Linux Manual Installation

1

Install Prerequisites

Ubuntu/Debian Prerequisites 
# Update package list
sudo apt update

# Install essential packages
sudo apt install -y git python3 python3-pip python3-venv curl wget

# Install Chrome
wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list
sudo apt update
sudo apt install -y google-chrome-stable
CentOS/RHEL Prerequisites 
# Install EPEL repository (if needed)
sudo yum install -y epel-release

# Install essential packages
sudo yum install -y git python3 python3-pip curl wget

# Install Chromium
sudo yum install -y chromium
Fedora Prerequisites 
# Install essential packages
sudo dnf install -y git python3 python3-pip curl wget

# Install Chromium
sudo dnf install -y chromium
Arch Linux Prerequisites 
# Update package database
sudo pacman -Sy

# Install essential packages
sudo pacman -S git python python-pip curl wget

# Install Chromium
sudo pacman -S chromium
2

Clone Repository

Git Clone 
git clone https://github.com/AryanVBW/AUTO-blogger.git
cd AUTO-blogger
3

Setup Virtual Environment

Virtual Environment 
# Create virtual environment
python3 -m venv auto_blogger_venv

# Activate virtual environment
source auto_blogger_venv/bin/activate

# Upgrade pip
pip install --upgrade pip
4

Install Dependencies

Python Dependencies 
# Install from requirements.txt
pip install -r requirements.txt

# Verify installation
python -c "import requests, selenium, openai; print('All packages installed successfully!')"
5

Create Launcher

System Launcher 
# Make autoblog script executable
chmod +x autoblog

# Create system-wide symlink (optional)
sudo ln -sf "$(pwd)/autoblog" /usr/local/bin/autoblog

# Test launcher
./autoblog --test

macOS macOS Manual Installation

1

Install Prerequisites

macOS Prerequisites 
# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install essential packages
brew install git python@3.11

# Install Chrome
brew install --cask google-chrome

# Verify installations
python3 --version
git --version
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --version
Alternative for Python: You can also download Python from python.org if you prefer not to use Homebrew.
2

Clone Repository

Git Clone 
# Clone to Applications folder (recommended)
cd ~/Applications
git clone https://github.com/AryanVBW/AUTO-blogger.git
cd AUTO-blogger
3

Setup Virtual Environment

Virtual Environment 
# Create virtual environment
python3 -m venv auto_blogger_venv

# Activate virtual environment
source auto_blogger_venv/bin/activate

# Upgrade pip
pip install --upgrade pip
4

Install Dependencies

Python Dependencies 
# Install from requirements.txt
pip install -r requirements.txt

# Verify installation
python -c "import requests, selenium, openai; print('All packages installed successfully!')"
5

Create macOS App Bundle

App Bundle Creation 
# Make autoblog script executable
chmod +x autoblog

# Create system-wide symlink
sudo ln -sf "$(pwd)/autoblog" /usr/local/bin/autoblog

# Add to PATH (add to ~/.zshrc or ~/.bash_profile)
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Test launcher
autoblog --test

Windows Windows Manual Installation

1

Install Prerequisites

Linux Windows Subsystem for Linux (WSL2)

WSL2 Setup 
# In PowerShell (Run as Administrator)
wsl --install -d Ubuntu

# Restart computer, then open Ubuntu terminal
# Update packages
sudo apt update
sudo apt upgrade -y

# Install prerequisites
sudo apt install -y git python3 python3-pip python3-venv curl wget

# Install Chrome
wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list
sudo apt update
sudo apt install -y google-chrome-stable

Windows Native Windows Installation

1. Install Python 3.8+

Download from python.org

Important: Check "Add Python to PATH" during installation

2. Install Git

Download from git-scm.com

Recommended: Use Git Bash as terminal

3. Install Google Chrome

Download from google.com/chrome

2

Clone Repository

Git Clone (Git Bash/WSL) 
# WSL/Git Bash
git clone https://github.com/AryanVBW/AUTO-blogger.git
cd AUTO-blogger
PowerShell Alternative 
# PowerShell
git clone https://github.com/AryanVBW/AUTO-blogger.git
Set-Location AUTO-blogger
3

Setup Virtual Environment

Virtual Environment (WSL/Git Bash) 
# Create virtual environment
python3 -m venv auto_blogger_venv

# Activate virtual environment
source auto_blogger_venv/bin/activate

# Upgrade pip
pip install --upgrade pip
Virtual Environment (PowerShell) 
# Create virtual environment
python -m venv auto_blogger_venv

# Activate virtual environment
auto_blogger_venv\Scripts\Activate.ps1

# Upgrade pip
pip install --upgrade pip
4

Install Dependencies

Python Dependencies 
# Install from requirements.txt
pip install -r requirements.txt

# Verify installation
python -c "import requests, selenium, openai; print('All packages installed successfully!')"
5

Create Windows Launcher

Batch File Launcher 
# Create autoblog.bat file
echo @echo off > autoblog.bat
echo cd /d "%~dp0" >> autoblog.bat
echo call auto_blogger_venv\Scripts\activate.bat >> autoblog.bat
echo python autoblog_launcher.py %* >> autoblog.bat

# Test launcher
autoblog.bat --test

Verification

After installation, verify that everything is working correctly:

Test Installation

Test Command 
# From installation directory
python3 gui_blogger.py --test

# Or using the launcher
autoblog --test

Launch Application

Launch 
# System-wide launcher (if installed)
$ autoblog

# Local launcher
$ ./autoblog

# Direct Python execution
$ python3 gui_blogger.py
Success Indicators:
  • GUI application opens without errors
  • All tabs are accessible
  • No import errors in the console
  • Browser automation test passes

Troubleshooting

Python Version Error

Problem: "Python 3.8+ required" error

Solution:

# Check Python version
python3 --version

# Install Python 3.8+ if needed
# Ubuntu/Debian
sudo apt install python3.8 python3.8-venv python3.8-pip

# macOS
brew install python@3.11

# Windows
# Download from https://www.python.org/downloads/

OS Detection Failed

Problem: "Unsupported operating system" error

Solution:

# Force OS detection
export FORCE_OS="linux"  # or "macos" or "windows"
./install_autoblog.sh

# Manual installation
# Follow the manual installation guide above

Network/Proxy Issues

Problem: Download failures or timeout errors

Solution:

# Configure proxy (if needed)
export http_proxy="http://proxy.company.com:8080"
export https_proxy="http://proxy.company.com:8080"

# Use alternative download method
wget https://github.com/AryanVBW/AUTO-blogger/archive/main.zip
unzip main.zip
cd AUTO-blogger-main

Package Manager Issues

Problem: Package installation failures

Solution:

# Update package lists
# Ubuntu/Debian
sudo apt update && sudo apt upgrade

# CentOS/RHEL
sudo yum update

# macOS
brew update && brew upgrade

# Clear package cache
sudo apt clean  # Ubuntu/Debian
brew cleanup    # macOS

❌ Permission Denied

Problem: Permission errors during installation

Solution:

# Make script executable
chmod +x install_autoblog.sh

# Run with proper permissions
sudo ./install_autoblog.sh

❌ Chrome/Chromium Not Found

Problem: Browser automation fails

Solution:

# Install Chrome manually
wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list
sudo apt update
sudo apt install google-chrome-stable

❌ Virtual Environment Issues

Problem: Virtual environment creation fails

Solution:

# Remove existing venv and recreate
rm -rf venv
python3 -m pip install --user virtualenv
python3 -m venv venv

🆘 Additional Help Resources

📚 Documentation

Comprehensive guides and API documentation

View Docs

🐛 Report Issues

Found a bug? Report it on GitHub

GitHub Issues

💬 Get Support

Direct email support for installation help

Email Support

🔧 System Diagnostics

Run built-in diagnostic tools

python3 -c "import sys; print(f'Python: {sys.version}'); import platform; print(f'OS: {platform.system()} {platform.release()}')"
⚠️ Common Installation Pitfalls:
  • Python Version: Ensure you're using Python 3.8 or higher
  • Virtual Environment: Always activate the virtual environment before running commands
  • Permissions: Some commands may require sudo/administrator privileges
  • Network: Ensure stable internet connection for downloads
  • Disk Space: Ensure at least 1GB free space for installation

🎯 Next Steps

After successful installation, here's what to do next:

🔐 Configure Authentication

Set up your WordPress, OpenAI, and other API credentials

Setup Guide

⚙️ Configure Settings

Customize automation preferences and SEO settings

Configuration

Start Automating

Begin automating your blog posting workflow

Usage Guide