๐Ÿš€ NEW: v1.10.2 with Platform Integration Fixes

Ultimate Social Media Automation
for Developers

One setup, full automation. Terraform-style workflow with 4 simple commands. Intelligent profile generation, content creation, and posting across 5 platforms - completely automated.

aetherpost-demo
$

๐Ÿ†• What's New in v1.10.2

๐Ÿ”ง FIXED

๐Ÿ”— Platform Integration

Complete fixes for Bluesky avatar upload, Twitter profile updates, and multilingual character encoding. All platforms now work seamlessly with proper API compliance.

# Fixed issues:
โœ… Bluesky AT Protocol blob upload
โœ… Twitter v1.1 profile API
โœ… UTF-8 encoding for all languages
๐ŸŽจ ENHANCED

๐Ÿ–ผ๏ธ Media Management

Automatic image optimization for platform limits, proper Content-Type headers, and AI avatar generation with fallback support. Perfect image handling across all platforms.

# Image optimization:
240KB โ†’ 24KB (Bluesky)
UTF-8 charset headers
OpenAI DALL-E 3 + PIL fallback
๐Ÿ› ๏ธ CI/CD

โš™๏ธ Build & Testing

Streamlined CI/CD workflows, simplified testing pipeline, and corrected package references. Faster builds with Python 3.10-3.11 focus and cleaner automation.

# CI improvements:
โœ… Package directory fixes
โœ… Python 3.10-3.11 testing
โœ… Workflow optimization
๐Ÿงช TESTED

โœ… Real API Testing

Comprehensive testing with live credentials, multilingual content validation, and end-to-end integration tests. Verified to work with actual platform APIs.

# Live testing results:
โœ… Twitter profile updates
โœ… Bluesky posting & avatars
โœ… Japanese/Korean/Chinese text

โšก Quick Start

1

Install AetherPost

pip install aetherpost
2

One-Time Setup

aetherpost init

Interactive setup generates campaign.yaml + creates profiles automatically

3

Deploy & Automate

aetherpost plan
aetherpost apply

Preview content, then deploy. Continuous automation begins instantly.

๐Ÿค– For AI Tools & Development

Two setup approaches available: Interactive (guided) or Automated (pre-configured files)

๐Ÿ“‹ Interactive Setup (One-time configuration)

pip install aetherpost
aetherpost init

# Single interactive session handles everything:
# 1. Project details โ†’ campaign.yaml generation
# 2. Platform selection โ†’ automated profile creation
# 3. API authentication โ†’ continuous automation setup
# 4. Then: plan โ†’ apply โ†’ fully automated promotion

โœ… One setup, full automation - One setup, lifetime automation
โœ… Smart generation - Profiles, content, posting schedules
โœ… Zero maintenance - Runs continuously after init

๐Ÿ“Š File Requirements Matrix

File Interactive Setup Automated Setup Purpose
campaign.yaml ๐Ÿ”„ Created during setup ๐Ÿ”ด Required upfront Project config, platforms, URLs
.env.aetherpost ๐Ÿ”„ Created during setup ๐Ÿ”ด Required upfront API keys and credentials

๐ŸŽญ Profile Generation Example

Example of AI-generated profiles based on your campaign.yaml settings:

Based on campaign.yaml with:
  name: "TaskMaster Pro"
  concept: "AI-powered project management"

AetherPost generates natural profiles like:

๐Ÿฆ Twitter Profile:
"Building TaskMaster Pro - an AI-powered project management tool that actually gets you! 
Helping teams ship faster with intelligent task prioritization. 
๐Ÿš€ https://taskmaster.app"

๐Ÿฆ‹ Bluesky Profile: 
"Creator of TaskMaster Pro - revolutionizing how teams manage projects with AI. 
Currently shipping v2.0 with smart notifications! 
Always excited to connect with fellow builders."

๐Ÿ˜ Mastodon Profile:
"Independent developer creating TaskMaster Pro. 
Passionate about building tools that enhance human productivity. 
Open source advocate and coffee enthusiast."

โœ… Your branding, โœ… Your URLs, โœ… Your message, โŒ No AetherPost mentions

๐ŸŒ Platform Support & API Requirements

Choose any combination of platforms. Start small and expand as needed.

๐Ÿฆ

Twitter

160-character optimized tweets with engagement features

API Requirements:
TWITTER_API_KEY
TWITTER_API_SECRET
TWITTER_ACCESS_TOKEN
TWITTER_ACCESS_TOKEN_SECRET
Current Status (2025):
โ€ข Free tier: Read-only access only
โ€ข Basic ($100/month): 10K tweets read, 1.5K writes
โ€ข Pro ($5,000/month): 1M tweets read, 300K writes
โ€ข Enterprise: Custom pricing
๐Ÿ’ฐ Requires paid Basic plan ($100/month minimum)
๐Ÿฆ‹

Bluesky

Decentralized social media with 256-character limit

API Requirements:
BLUESKY_HANDLE (username.bsky.social)
BLUESKY_PASSWORD (app password)
Current Status (2025):
โ€ข Completely free API access
โ€ข No rate limits on posting
โ€ข Open-source AT Protocol
โ€ข Growing user base (15M+ users)
โœ… Free API access - Recommended
๐Ÿ“ธ

Instagram

Visual content optimization and profile management

API Requirements:
INSTAGRAM_ACCESS_TOKEN
INSTAGRAM_BUSINESS_ACCOUNT_ID
Current Status (2025):
โ€ข Basic Display API: Free (profile only)
โ€ข Graph API: Free for basic features
โ€ข Requires Facebook Page connection
โ€ข Business account verification needed
โš ๏ธ Business account + Facebook Page required
๐Ÿ˜

Mastodon

Decentralized open-source social network with community focus

API Requirements:
MASTODON_ACCESS_TOKEN
MASTODON_INSTANCE_URL
Current Status (2025):
โ€ข Completely free API access
โ€ข No corporate restrictions
โ€ข Choose your own instance
โ€ข Open-source community platform
โœ… Free and open-source
๐Ÿ“บ

YouTube

Channel optimization and content strategy

API Requirements:
YOUTUBE_CLIENT_ID
YOUTUBE_CLIENT_SECRET
YOUTUBE_REFRESH_TOKEN (optional)
Current Status (2025):
โ€ข Free quota: 10,000 units/day
โ€ข Read operations: 1 unit each
โ€ข Write operations: 50-1600 units
โ€ข OAuth 2.0 authentication required
โœ… Free quota (10,000 units/day)

๐Ÿš€ Key Features

๐Ÿค– AI-Powered Content

GPT-powered content generation with platform-specific optimization and intelligent hashtag selection.

๐ŸŽฏ 4-Command Simplicity

Pure Terraform workflow: init โ†’ plan โ†’ apply โ†’ destroy. No complex sub-commands or confusing options.

๐Ÿ” Smart Auto-Detection

Pre-existing campaign.yaml? AetherPost detects it instantly and skips interactive setup. Perfect for automation.

โ™พ๏ธ Complete Automation

One setup, full automation. Profile generation, content creation, posting schedules - fully automated after init.

๐Ÿ”’ Type Safe

95% type coverage with comprehensive type hints and structured error responses.

๐Ÿงช 100% Tested

Comprehensive test suite with real API validation ensuring production reliability.