Installation Guide

Get AetherPost installed on your system with multiple installation methods.

Install with pip

The easiest way to install AetherPost is using pip. This method works on Windows, macOS, and Linux.

Requirements

  • Python 3.8 or later
  • pip (Python package manager)

Step 1: Check Python Version

python --version
# Should show Python 3.8 or later

Step 2: Install AetherPost

# Install AetherPost
pip install aetherpost

# Or install with specific extras
pip install aetherpost[all]  # All optional dependencies

Step 3: Verify Installation

aetherpost --version
aetherpost --help
Tip: Use a virtual environment to avoid conflicts with other Python packages: 
python -m venv aetherpost-env
source aetherpost-env/bin/activate  # On Windows: aetherpost-env\Scripts\activate
pip install aetherpost

Install from Git

Install the latest development version directly from GitHub.

Requirements

  • Git
  • Python 3.8 or later
  • pip

Step 1: Clone Repository

git clone https://github.com/fununnn/aetherpost.git
cd aetherpost

Step 2: One Command Setup

aetherpost init
# Handles dependencies, configuration, everything!

Step 3: Manual Install (if needed)

# Install in development mode
pip install -e .

# Or install with development dependencies
pip install -e ".[dev]"

Step 3: Verify Installation

python -m aetherpost --version

Install with Docker

Run AetherPost in a containerized environment with Docker.

Requirements

  • Docker
  • Docker Compose (optional)

Option 1: Docker Run

# Run AetherPost interactively
docker run -it --rm aetherpost/aetherpost:latest

# Run with volume for persistent data
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  aetherpost/aetherpost:latest

Option 2: Docker Compose

# Download docker-compose.yml
curl -O https://raw.githubusercontent.com/your-org/aetherpost/main/docker-compose.yml

# Start AetherPost
docker-compose up -d

Custom Docker Build

# Clone and build
git clone https://github.com/fununnn/aetherpost.git
cd aetherpost
docker build -t my-aetherpost .
docker run -it my-aetherpost

Install from Source

Build and install AetherPost from source code for maximum customization.

Requirements

  • Python 3.8 or later
  • Git
  • Build tools (gcc, make, etc.)

Step 1: Clone and Setup

git clone https://github.com/fununnn/aetherpost.git
cd aetherpost

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Step 2: Install Build Dependencies

# Install build requirements
pip install build wheel setuptools

# Install development dependencies
pip install -r requirements-dev.txt

Step 3: Build and Install

# Build package
python -m build

# Install built package
pip install dist/aetherpost-*.whl

Platform-Specific Instructions

Windows Installation

  1. Install Python from python.org
  2. Open Command Prompt or PowerShell
  3. Run: pip install aetherpost
Windows Note: If you encounter permission errors, try running Command Prompt as Administrator or use pip install --user aetherpost

macOS Installation

  1. Install Python via Homebrew: brew install python
  2. Or download from python.org
  3. Run: pip3 install aetherpost
macOS Tip: You might need to use pip3 instead of pip if you have multiple Python versions installed.

Linux Installation

Ubuntu/Debian:

sudo apt update
sudo apt install python3 python3-pip
pip3 install aetherpost

CentOS/RHEL:

sudo yum install python3 python3-pip
pip3 install aetherpost

Arch Linux:

sudo pacman -S python python-pip
pip install aetherpost

Troubleshooting

Command not found: aetherpost

If you get "command not found" after installation:

  1. Check if pip installed to user directory: pip show -f aetherpost
  2. Add user bin directory to PATH: 
    # Linux/macOS
export PATH="$PATH:$(python -m site --user-base)/bin"

# Windows
set PATH=%PATH%;%APPDATA%\Python\Python3X\Scripts
  3. Or use: python -m aetherpost

Permission denied errors

  • Use virtual environment (recommended)
  • Install to user directory: pip install --user aetherpost
  • On Windows: Run Command Prompt as Administrator

Python version conflicts

  • Use specific Python version: python3.9 -m pip install aetherpost
  • Create virtual environment with specific version: python3.9 -m venv venv

Next Steps

Quick Start

Create your first campaign in 5 minutes

Get Started →

Configuration

Configure AetherPost for your needs

Configure →

Platform Setup

Connect your social media accounts

Setup Platforms →