{"id":29063920,"url":"https://github.com/fununnn/aetherpost","last_synced_at":"2026-04-14T00:04:49.758Z","repository":{"id":299630590,"uuid":"1003650779","full_name":"fununnn/aetherpost","owner":"fununnn","description":"🚀 AI-powered multi-platform social media promotion tool with automated content generation and profile management","archived":false,"fork":false,"pushed_at":"2025-06-26T13:40:19.000Z","size":2876,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-26T13:53:46.858Z","etag":null,"topics":["ai","automation","bluesky","cli","content-generation","instagram","marketing","python","reddit","social-media","twitter","youtube"],"latest_commit_sha":null,"homepage":"https://aether-post.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fununnn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-17T13:13:38.000Z","updated_at":"2025-06-26T13:39:18.000Z","dependencies_parsed_at":"2025-06-17T14:37:38.536Z","dependency_job_id":null,"html_url":"https://github.com/fununnn/aetherpost","commit_stats":null,"previous_names":["fununnn/aetherpost"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/fununnn/aetherpost","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fununnn%2Faetherpost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fununnn%2Faetherpost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fununnn%2Faetherpost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fununnn%2Faetherpost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fununnn","download_url":"https://codeload.github.com/fununnn/aetherpost/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fununnn%2Faetherpost/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262227896,"owners_count":23278266,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","automation","bluesky","cli","content-generation","instagram","marketing","python","reddit","social-media","twitter","youtube"],"created_at":"2025-06-27T09:02:02.615Z","updated_at":"2026-04-14T00:04:49.730Z","avatar_url":"https://github.com/fununnn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AetherPost - Promotion as Code\n\n🚀 **AI-powered social media automation for developers**\n\nAetherPost automates your app promotion across social media platforms using AI-generated content and Infrastructure-as-Code principles.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)\n[![AI-Friendly](https://img.shields.io/badge/AI--Friendly-Claude%20Code%20%7C%20Copilot-purple.svg)](CODE_GUIDELINES.md)\n[![Beginner-Friendly](https://img.shields.io/badge/Beginner--Friendly-GUI%20Setup-green.svg)](GUI_SETUP_GUIDE.md)\n\n## ✨ Features\n\n### OSS Edition (Free)\n- 🎯 **Declarative configuration** - Define campaigns in YAML\n- 🤖 **AI-generated content** - OpenAI GPT-powered posts\n- 📱 **Multi-platform support** - Twitter, Reddit, YouTube, Bluesky, Instagram (5 platforms)\n- 🆕 **Universal profile management** - Sync profiles across all platforms automatically\n- 🔒 **Secure** - Encrypted credential storage with .env.aetherpost\n- ⚡ **Auto-setup mode** - Zero-prompt initialization for AI tools\n- 📊 **Smart notifications** - Slack/LINE preview notifications\n- 🎨 **Style options** - Casual, professional, technical, humorous\n- 🌍 **Multi-language** - 20+ languages supported\n- 📝 **Usage limits** - 50 posts/day, 5 campaigns\n\n### Key Capabilities\n- 🚀 **Two setup modes** - Auto-setup (Claude Code) vs Interactive prompts\n- 🔄 **Terraform-style workflow** - init, plan, apply commands\n- 📱 **Notification modes** - Preview confirmations or auto-posting\n- 🎯 **API tier system** - Starter, Recommended, Advanced, Complete\n- ⚡ **Production ready** - 100% tested with real API validation\n\n## 🚀 Quick Start\n\nAetherPost supports **two setup modes** based on file detection:\n\n### 🤖 Auto Setup Mode\n\n**For automated workflows with pre-configured files**\n\n```bash\n# 1. Install AetherPost\npip install aetherpost\n\n# 2. Pre-create configuration files:\n#    - campaign.yaml (project settings)\n#    - .env.aetherpost (API keys)\n\n# 3. Auto-initialize (zero prompts)\naetherpost init\n\n# 4. Preview and deploy\naetherpost plan \u0026\u0026 aetherpost apply\n```\n\n### 📝 Interactive Setup Mode (Manual Configuration)\n\n**For step-by-step guided setup**\n\n```bash\n# 1. Install AetherPost\npip install aetherpost\n\n# 2. Interactive setup with prompts\naetherpost init\n\n# 3. Preview and deploy\naetherpost plan \u0026\u0026 aetherpost apply\n```\n\n\u003e **Auto-Detection:** If `campaign.yaml` exists → Auto Setup Mode, otherwise → Interactive Setup Mode\n\n## 📋 Configuration Examples\n\n### Complete campaign.yaml\n```yaml\nname: \"my-awesome-app\"\nconcept: \"AI-powered task manager that learns your habits\"\nurl: \"https://github.com/user/my-awesome-app\"\nplatforms: \n  - twitter\n  - reddit\n  - youtube\n\ncontent:\n  style: professional  # casual, professional, technical, humorous\n  action: \"Try it free!\"\n  language: en  # en, ja, es, fr, de, ko, zh, pt, ru, ar, etc.\n  hashtags:\n    - \"#AI\"\n    - \"#ProductivityTool\"\n    - \"#OpenSource\"\n\nlimits:\n  free_tier: true\n  max_posts_per_day: 50\n\nnotifications:\n  enabled: true      # Send preview notifications\n  auto_apply: false  # Require confirmation (set true for auto-posting)\n\n# Optional: Template hint for advanced features\ntemplate: \"production\"  # starter, production, enterprise\n```\n\n### API Configuration (.env.aetherpost)\n```bash\n# AI Services (Required)\nOPENAI_API_KEY=sk-proj-your_openai_key_here\n\n# Twitter (Required for Twitter platform)\nTWITTER_API_KEY=your_twitter_api_key_here\nTWITTER_API_SECRET=your_twitter_api_secret_here\nTWITTER_ACCESS_TOKEN=your_twitter_access_token_here\nTWITTER_ACCESS_TOKEN_SECRET=your_twitter_access_token_secret_here\n\n# Reddit (Required for Reddit platform)\nREDDIT_CLIENT_ID=your_reddit_client_id_here\nREDDIT_CLIENT_SECRET=your_reddit_client_secret_here\nREDDIT_USERNAME=your_reddit_username_here\nREDDIT_PASSWORD=your_reddit_password_here\n\n# YouTube (Required for YouTube platform)\nYOUTUBE_CLIENT_ID=your_youtube_client_id_here\nYOUTUBE_CLIENT_SECRET=your_youtube_client_secret_here\n\n# Notifications (Optional)\nSLACK_WEBHOOK_URL=https://hooks.slack.com/services/your/webhook/url\n```\n\n### Multi-Language Examples\n```yaml\n# Japanese Campaign\ncontent:\n  style: casual\n  action: \"今すぐ試してみてください！\"\n  language: ja\n  hashtags: [\"#AI\", \"#生産性\", \"#ツール\"]\n\n# Spanish Campaign  \ncontent:\n  style: professional\n  action: \"Pruébalo ahora\"\n  language: es\n  hashtags: [\"#IA\", \"#Productividad\"]\n```\n\n**Supported Languages**: English (en), Japanese (ja), Spanish (es), French (fr), German (de), Korean (ko), Chinese (zh), Portuguese (pt), Russian (ru), Arabic (ar), and more.\n\n## 🔧 Commands (Terraform-style)\n\n| Command | Description | Mode |\n|---------|-------------|------|\n| `aetherpost init` | Initialize workspace (auto-detects existing config) | Auto/Interactive |\n| `aetherpost plan` | Preview AI-generated content for all platforms | Both |\n| `aetherpost apply` | Execute campaign (respects notification settings) | Both |\n| `aetherpost status` | Check campaign status and analytics | Both |\n| `aetherpost auth` | Manage API authentication | Both |\n\n### Notification Modes\n- **Preview Mode** (`notifications.enabled: true`) - Sends preview notification before posting\n- **Auto Mode** (`notifications.auto_apply: true`) - Posts immediately without confirmation\n\n## 🔑 API Requirements\n\n### Quick Reference\n| Level | APIs Required | Monthly Cost | Setup Time |\n|-------|---------------|--------------|------------|\n| **Starter** | OpenAI + Twitter | $5-15 | ~10 min |\n| **Recommended** | + Reddit | $5-15 | ~20 min |\n| **Advanced** | + YouTube | $10-25 | ~30 min |\n| **Complete** | + Bluesky + Instagram | $15-35 | ~45 min |\n\n\u003e 💡 **Auto Setup**: The `aetherpost init` command guides you through API collection with direct setup links and validation.\n\n## 📖 Documentation\n\n### For AI Tools \u0026 Claude Code\n| Document | Purpose | Use Case |\n|----------|---------|----------|\n| **[AUTO_SETUP_README.md](AUTO_SETUP_README.md)** | **Auto-setup guide** | **Zero-prompt automation** |\n| [sample-campaign.yaml](sample-campaign.yaml) | Configuration template | File generation |\n| [sample.env.aetherpost](sample.env.aetherpost) | API keys template | Environment setup |\n\n### For Manual Setup\n**🌐 [Complete Documentation Site](https://d3b75mcubdhimz.cloudfront.net)**\n\n| Document | Purpose |\n|----------|---------|\n| [Getting Started](https://d3b75mcubdhimz.cloudfront.net/getting-started.html) | Step-by-step guide |\n| [API Requirements](https://d3b75mcubdhimz.cloudfront.net/#api-requirements) | API setup levels |\n| [Platform Setup](https://d3b75mcubdhimz.cloudfront.net/guides/platforms.html) | Platform integration |\n\n## 🤝 Contributing\n\n**AetherPost welcomes all contributors!** We're an AI-friendly OSS project that supports modern development workflows.\n\n### 🤖 AI-Assisted Development Welcome\n- ✅ **Claude Code, GitHub Copilot, and other AI tools fully supported**\n- ✅ **AI-generated code accepted** (with proper review and testing)\n- ✅ **Co-author credit** for AI contributions encouraged\n\n### 🔰 Beginner-Friendly\n- 📖 **[GUI Setup Guide](GUI_SETUP_GUIDE.md)** - No command line required!\n- 📋 **[Code Guidelines](CODE_GUIDELINES.md)** - Comprehensive standards\n- 🛠️ **[Contributing Guide](CONTRIBUTING.md)** - Step-by-step process\n\n### 🎯 Contribution Opportunities\n- **New platform connectors** (Instagram, LinkedIn, TikTok)\n- **AI provider integrations** (Google Gemini, local models)\n- **Analytics and visualization**\n- **Documentation and tutorials**\n- **Bug fixes and improvements**\n\n**Get started**: [CONTRIBUTING.md](CONTRIBUTING.md) | **Need help?** [GitHub Discussions](https://github.com/fununnn/aetherpost/discussions)\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Inspired by Terraform's Infrastructure-as-Code approach\n- Built with [Typer](https://typer.tiangolo.com/) and [Rich](https://rich.readthedocs.io/)\n- AI content generation powered by advanced language models and [OpenAI](https://openai.com/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffununnn%2Faetherpost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffununnn%2Faetherpost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffununnn%2Faetherpost/lists"}