5-platform social media automation with integrated profile management. Deploy to Twitter, Reddit, YouTube, Bluesky, and Instagram with intelligent content optimization and AI-generated profiles. One command setup, complete automation.
# 1. Install AetherPost
pip install aetherpost
# 2. Create campaign.yaml (pre-configure settings)
# 3. Create .env.aetherpost (add API keys)
# 4. Auto-initialize with profile generation
aetherpost init
# 5. Preview and deploy
aetherpost plan
aetherpost apply
💡 For Claude Code & AI Tools: Pre-create campaign.yaml and .env.aetherpost files. AetherPost will auto-detect, skip prompts, and auto-generate profiles.
🎯 Platform Flexibility: Choose any combination of platforms - you don't need all 5. Start with 1-2 platforms and expand as needed.
📱 New in v1.6.0: Automatic profile generation and application during init. Multi-URL support for better content optimization.
# 1. Install AetherPost
pip install aetherpost
# 2. Interactive setup with profile generation
aetherpost init
# 3. Preview and deploy
aetherpost plan
aetherpost apply
📝 For Manual Setup: AetherPost will guide you through project setup, API collection, platform configuration, and automatic profile generation.
🎯 Platform Choice: Select only the platforms you want to use. Start small with Bluesky + Reddit, then add YouTube, Instagram, or Twitter later.
📱 Profile Integration: Profiles are automatically generated and applied during setup - no separate commands needed.
⚠️ Twitter/X Note: Twitter now requires a paid API plan ($100/month minimum). We recommend starting with Bluesky (free) for social media automation.
name: "AI Product Launch"
concept: "Revolutionary AI productivity app"
urls:
main: https://myapp.com
github: https://github.com/user/myapp
docs: https://myapp.com/docs
platforms: [bluesky, reddit] # Start with 2 platforms
content:
style: professional
ai_enhanced: true
hashtags: ["AI", "productivity"]
$ aetherpost plan
📋 Campaign Preview
✅ Bluesky: "🚀 Introducing revolutionary AI productivity app..."
✅ Reddit: "Deep dive: How AI transforms productivity workflows..."
💡 Run 'aetherpost apply' to execute this campaign
$ aetherpost apply
🚀 Campaign Execution
✅ Posted to Bluesky: https://bsky.app/...
✅ Posted to Reddit: r/programming
🎉 Successfully posted to 2/2 platforms!
Watch the complete workflow in action - from init to deployment
$ pip install aetherpost $ aetherpost init $ aetherpost plan $ aetherpost apply ✅ Posted to 5 platforms successfully!
aetherpost init
Initialize project with auto-dependency installation
aetherpost plan
Preview AI-generated content for all platforms
aetherpost apply
Execute campaign across Bluesky, Reddit, YouTube, Instagram, Twitter*
aetherpost destroy
Clean up and remove posted content
GPT-3.5-turbo powered content generation with platform-specific optimization and intelligent hashtag selection.
AI Setup Guide →Most comprehensive platform support: Bluesky, Reddit, YouTube, Instagram, Twitter*. Mix and match any combination. Start with 1, scale to all 5. Each platform intelligently optimized.
Guided prompts for project concept, platforms, language, and style selection.
See Setup →95% type coverage with comprehensive type hints, dataclasses, and robust error handling.
Dev Guide →Interactive setup by default, with --quick flag for CI/CD, cron jobs, and automated workflows.
Automation →Comprehensive test suite with real API validation, ensuring production reliability.
Test Report →✨ New in v1.5.0! Sync your project's profile across all platforms automatically. One YAML config updates Twitter, Bluesky, Mastodon, Instagram & Discord profiles with platform-optimized content.
Profile Guide →For automated project initialization
campaign.yaml
with project configuration.env.aetherpost
with API keysaetherpost init
(auto-detects files)aetherpost plan && aetherpost apply
Result: Zero interactive prompts, instant setup
Minimum files for auto-setup
campaign.yaml
- Project settings & platforms.env.aetherpost
- API credentialsOptional:
README.md
- Project documentation.gitignore
- Git ignore patterns# campaign.yaml
name: "my-project"
concept: "Project description"
platforms: ["twitter", "reddit"]
content:
style: professional
language: en
notifications:
enabled: true
auto_apply: false
# .env.aetherpost (Starter - $5/month)
OPENAI_API_KEY=sk-proj-xxx
TWITTER_API_KEY=xxx
TWITTER_API_SECRET=xxx
TWITTER_ACCESS_TOKEN=xxx
TWITTER_ACCESS_TOKEN_SECRET=xxx
# Add more platforms when ready:
# REDDIT_CLIENT_ID=xxx
# REDDIT_CLIENT_SECRET=xxx
# REDDIT_USERNAME=xxx
# REDDIT_PASSWORD=xxx
# YOUTUBE_CLIENT_ID=xxx
# YOUTUBE_CLIENT_SECRET=xxx
# BLUESKY_HANDLE=your_handle.bsky.social
# BLUESKY_PASSWORD=your_app_password
# INSTAGRAM_ACCESS_TOKEN=xxx
# INSTAGRAM_BUSINESS_ACCOUNT_ID=xxx
# SLACK_WEBHOOK_URL=https://hooks.slack.com/...
💡 Tip: Start with OpenAI + Bluesky (free), then uncomment and fill in other platforms as needed. Note: Twitter requires a paid API plan ($100/month).
// 1. Create campaign.yaml based on project analysis
const campaignConfig = {
name: projectName,
concept: projectDescription,
platforms: determinePlatforms(projectType),
content: {
style: 'professional',
language: 'en'
},
notifications: {
enabled: true,
auto_apply: false // Set to true for full automation
}
};
// 2. Create .env.aetherpost template
const envTemplate = `OPENAI_API_KEY=\${OPENAI_API_KEY}
TWITTER_API_KEY=\${TWITTER_API_KEY}
TWITTER_API_SECRET=\${TWITTER_API_SECRET}
// ... other required keys`;
// 3. User adds API keys to .env.aetherpost
// 4. Auto-initialize
exec('aetherpost init'); // No prompts, instant setup
// 5. Execute campaign
exec('aetherpost plan && aetherpost apply');
Choose your own adventure! AetherPost supports any combination of platforms.
Start with just Bluesky (free), add Reddit for developer communities, then expand to YouTube, Instagram, or Twitter (paid) when ready.
The interactive aetherpost init
will guide you through the process.
~10 minutes
Personal projects, quick announcements, basic automation
~20 minutes
OSS projects, developer tools, startup launches. Most popular choice - covers the largest developer audience with minimal cost.
~30 minutes
Content creators, comprehensive campaigns, brand building
~45 minutes
Enterprise use, maximum reach, professional campaigns
Don't worry about setting everything up manually! Run aetherpost init
and it will:
.env.aetherpost
Step-by-step instructions for setting up each platform. Bookmark this section for reference during setup.
sk-proj-
)OPENAI_API_KEY=sk-proj-your-key
Begin with OpenAI + Twitter. Get comfortable with the workflow, then add Reddit, then expand to other platforms.
After adding API keys, use aetherpost plan
to verify each platform is working before going live.
Never commit .env.aetherpost to Git. Add it to .gitignore immediately. Treat API keys like passwords.
Each platform has rate limits. AetherPost handles this automatically, but be aware for high-volume usage.
name: "simple-start"
concept: "Developer-friendly social media automation platform"
platforms: [twitter, reddit] # Perfect starter combo
content:
style: casual
action: "Try it free!"
hashtags: ["#OpenSource", "#SocialMediaAutomation", "#Developer"]
promotion_themes:
- "🚀 Open source social media automation for developers"
- "🤖 AI-powered content generation with OpenAI integration"
- "📱 Multi-platform posting: Twitter, Reddit, YouTube, Bluesky, Instagram"
- "⚡ Simple CLI interface - no complex dashboards needed"
reddit_strategy:
target_subreddits: ["programming", "Python", "opensource", "DevTools"]
content_approach: "Focus on technical implementation details"
name: "Maximum Reach Campaign"
concept: "AI-powered productivity suite for modern teams"
platforms: [twitter, reddit, youtube, bluesky, instagram] # All 5!
content:
style: professional
action: "Experience the future of work!"
hashtags: ["#AI", "#Productivity", "#TeamWork", "#Innovation"]
platform_optimization:
twitter: "Quick announcements & updates"
reddit: "Technical discussions & community building"
youtube: "Product demos & tutorials"
bluesky: "Decentralized community engagement"
instagram: "Visual brand storytelling"
name: "TechStartup Launch"
concept: "Revolutionary AI productivity platform"
platforms: [twitter, youtube, reddit, bluesky, instagram]
content:
style: professional
action: "Join the beta!"
ai_enhanced: true
hashtags: ["startup", "ai", "productivity"]
schedule:
type: recurring
frequency: "daily"
times: ["09:00", "13:00", "18:00"]
analytics: true
name: "MyLibrary v2.0"
concept: "Open source library for developers"
platforms: [twitter, reddit, youtube, bluesky, instagram]
content:
style: technical
action: "Check it out on GitHub!"
hashtags: ["opensource", "developer", "library"]
github:
repository: "myuser/mylibrary"
release_tag: "v2.0.0"
template: "oss-release"
Help build the future of AI-powered social media automation. All skill levels welcome!
Enhance AI capabilities, improve content generation, or integrate new AI providers.
Add support for new social media platforms or improve existing integrations.
Test the interactive features and share your experience with the community!