https://raw.githubusercontent.com/LuisAlejandro/agoras/develop/docs/_static/title.svg
PyPI Package Github Releases Github Issues Push Coverage Contributor License Agreement Read The Docs Discord Channel

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, agoras

  • 10 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 post instead of agoras 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

Reference

Advanced Topics

Developer Documentation

Made with 💖 and 🍔

https://raw.githubusercontent.com/LuisAlejandro/LuisAlejandro/master/images/author-banner.svg