Agoras is a python utility that helps publish and delete posts on the most popular social networks (X (formerly Twitter), Facebook, Instagram, LinkedIn, Discord, YouTube, TikTok, Threads, Telegram, and WhatsApp).
This repository stores the application. There’s also GitHub actions that you can incorporate into your workflows.
For more information, please read the full documentation.
Architecture¶
Agoras uses a modular five-package structure. Install only the components you need, or pip install agoras for the full CLI.
Package structure:
agoras (CLI)
└── agoras-platforms
└── agoras-core
├── agoras-media
└── agoras-common
Capabilities:
Modular packages:
agoras-common,agoras-media,agoras-core,agoras-platforms,agoras10 platforms: X, Facebook, Instagram, LinkedIn, Discord, YouTube, TikTok, Threads, Telegram, WhatsApp
OAuth callback server: Easier browser-based authentication on supported networks
Platform-first CLI:
agoras x postinstead ofagoras publish --network x --action post
Upgrading from Agoras 1.x? See Migration Guide: Legacy to New CLI.
Table of Contents¶
Getting Started¶
Platform Guides¶
Getting Credentials¶
- X (formerly Twitter) credentials
- Facebook credentials
- Instagram credentials
- LinkedIn credentials
- Discord credentials
- Google credentials
- YouTube OAuth 2.0 Credentials
- Create Google OAuth Credentials for YouTube
- Authorize Agoras for YouTube
- CI/CD Setup (Unattended Execution)
- YouTube Parameters
- Google Sheets Credentials (for Scheduling)
- Create a new project
- Enable access to APIs in project
- Create Service Account credentials
- Create JSON file with credentials
- Agoras parameters
- TikTok credentials
- Threads credentials
- Prerequisites
- Create a Meta Developer Account
- Create a Meta App
- Add Threads API Product
- Configure OAuth Settings
- Get App Credentials
- Business Account Setup (Optional but Recommended)
- App Review Process
- Authorize Agoras
- CI/CD Setup (Unattended Execution)
- Development vs Production
- Agoras parameters
- Troubleshooting
- Telegram credentials
- WhatsApp credentials
- Meta Developer Account Setup
- WhatsApp Business Account Setup
- Phone Number Registration
- Access Token Generation
- Business Account ID (Optional)
- Recipient Phone Number
- Rate Limiting and Compliance
- Troubleshooting
- Test your setup
- CI/CD Setup (Unattended Execution)
- Agoras parameters
- Security Best Practices
- Additional Resources
- Google credentials
Reference¶
- Action Support Matrix
- Complete Parameter Reference
- Authentication Parameters
- Content Parameters
- Platform-Specific Parameters
- Utils Command Parameters
- Legacy Parameters
- Platform Arguments and Environment Variables Reference
- X (formerly Twitter)
- Discord
- YouTube
- TikTok
- Threads
- Telegram
- Environment Variable Naming Patterns
- See Also
Advanced Topics¶
Developer Documentation¶
Made with 💖 and 🍔¶
Web luisalejandro.org · GitHub @LuisAlejandro · Twitter @LuisAlejandro
