One setup, full automation. Terraform-style workflow with 4 simple commands. Intelligent profile generation, content creation, and posting across 5 platforms - completely automated.
Dynamic content generation that reads your project files, understands your codebase, and creates unique posts every time. Never repeat the same promotional content!
# AetherPost reads your project: ./src/features/awesome-feature.js ./README.md, ./CHANGELOG.md → Generates context-aware posts!
Automatic version change detection! AetherPost watches for updates in package.json, pyproject.toml, and more - creating special announcement posts for new releases.
# Detects: v1.9.0 → v1.10.0 "🎉 Major update! TaskMaster Pro v1.10.0" "✨ New: Project context awareness" "🚀 Try it now: npm install taskmaster"
Advanced file validation, secret scanning, and whitelist-based access control. Your sensitive files stay protected while AetherPost reads only what's needed.
# Built-in protections: "🚫 Path traversal blocked" "🔍 Secret patterns detected" "⚙️ Configurable exclusions"
Post history tracking ensures you never repeat content. Each post is unique, relevant, and tailored to your project's current state and recent changes.
# Different post every time: "🔧 Enhanced error handling..." "📊 Performance improvements..." "🎨 New UI components..."
pip install aetherpost
aetherpost init
Interactive setup generates campaign.yaml + creates profiles automatically
aetherpost plan aetherpost apply
Preview content, then deploy. Continuous automation begins instantly.
Two setup approaches available: Interactive (guided) or Automated (pre-configured files)
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 | 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 |
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
Choose any combination of platforms. Start small and expand as needed.
160-character optimized tweets with engagement features
TWITTER_API_KEYTWITTER_API_SECRETTWITTER_ACCESS_TOKENTWITTER_ACCESS_TOKEN_SECRET
Decentralized social media with 256-character limit
BLUESKY_HANDLE (username.bsky.social)BLUESKY_PASSWORD (app password)
Visual content optimization and profile management
INSTAGRAM_ACCESS_TOKENINSTAGRAM_BUSINESS_ACCOUNT_ID
Decentralized open-source social network with community focus
MASTODON_ACCESS_TOKENMASTODON_INSTANCE_URL
Channel optimization and content strategy
YOUTUBE_CLIENT_IDYOUTUBE_CLIENT_SECRETYOUTUBE_REFRESH_TOKEN (optional)
GPT-powered content generation with platform-specific optimization and intelligent hashtag selection.
Pure Terraform workflow: init → plan → apply → destroy. No complex sub-commands or confusing options.
Pre-existing campaign.yaml? AetherPost detects it instantly and skips interactive setup. Perfect for automation.
One setup, full automation. Profile generation, content creation, posting schedules - fully automated after init.
95% type coverage with comprehensive type hints and structured error responses.
Comprehensive test suite with real API validation ensuring production reliability.