Skip to content
Get packs

Guide · Open source

How to use social-auto-upload: install, log in and publish videos

Updated · written with AI from the project's own documentation and checked against our catalogue data

social-auto-upload is an open-source Python tool for publishing videos, articles and image posts to social media platforms such as Douyin, Xiaohongshu, Bilibili, YouTube and TikTok. It provides a unified sau command line and packaged skills that AI agents can use. This guide covers what it is suited for, how to clone and set it up, how to log in per platform, and how to publish a video from the terminal.

social-auto-uploaddreammis/social-auto-upload · ★ 16k · MIT

Quick start

  1. 1Check requirements. Confirm you have Python 3.10 to 3.12 and that your target platform is in the README support table.
  2. 2Clone the repository. Run git clone on the GitHub repository, then follow docs/install.md to build it.
  3. 3Log in to a platform. Run sau with the platform name and login, using an --account name you choose.
  4. 4Check the session. Run the check command with the same account name to confirm the session is active.
  5. 5Upload a video. Run upload-video with the file path, title and description, adding any platform-specific options from docs/CLI.md.
  6. 6Optionally install a skill. Use npx skills add with the skill folder name if you want an AI agent to run publishing tasks.

What social-auto-upload is and who it is for

social-auto-upload is a multi-platform publishing tool aimed at content creators and operators. The README describes it as offering a unified CLI and Skills that agents such as Codex, OpenClaw and Claude Code can use. People use it to avoid repeating the same upload steps on each platform.

  • Content creators posting the same video to several platforms
  • Operators managing multiple accounts on Douyin and Xiaohongshu
  • Developers who want scripted or agent-driven publishing
  • Users comfortable with Python and the command line

Check the requirements before you install

The project lists Python 3.10 to 3.12 as its prerequisite. The README centres on CLI commands and install documents, so this tool is not a point-and-click app. Check the platform support table before you start, because only the platforms listed there are supported.

  • Python 3.10-3.12
  • Comfort with a terminal
  • The platform you want must appear in the README support table

Clone the repository and install

Install is clone-and-build. Clone the repository from GitHub, then follow the install guide in docs/install.md for the build steps. The README links that document for ordinary users, and it also recommends uv for agent-driven setups.

  • Full install steps are in docs/install.md and updates in docs/update.md
git clone https://github.com/dreammis/social-auto-upload

Log in to each platform and check the session

Log in once per platform, then check the saved session. The --account value is a name you choose, such as creator, to tell several accounts apart. Login requirements differ by platform, so read the linked document for that platform.

  • Use one --account name per account you manage
  • Replace douyin with other platform names such as dayu, xueqiu or zhihu
sau douyin login --account creator sau douyin check --account creator

Publish a video from the command line

Use the upload-video command with the platform name, your account name, the video file and the title and description. Some platforms take extra options: Bilibili takes --tid, Tencent and several others take --tags, YouTube takes --playlist and --visibility. Replace <account_name> with the name you used at login.

  • Use the platform argument from the README table (for example douyin, kuaishou, xiaohongshu, bilibili, tencent, youtube)
  • Check docs/CLI.md for the full parameter list per platform
sau douyin upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"

Use agent skills (optional)

Skills are packaged per platform so compatible agents can run publishing tasks. To install a single skill from GitHub, use the npx command below. The README notes that the directory name can be swapped for the cross-platform entry or another platform's folder name.

  • Douyin skill is listed on skills.sh
  • Full skill list and distribution status are in docs/skill-distribution.md
  • The README states that sau skill install is not a command this project provides
npx skills add dreammis/social-auto-upload --skill douyin-upload

Know which platforms are stable

The support table marks features as supported with a check, and some as in development or experimental. The README says those marked as in development or experimental are not counted as stable. YouTube scheduling is marked in development and Zhihu scheduling is marked experimental.

  • YouTube scheduling: in development
  • Zhihu scheduling: experimental
  • TikTok: Chrome-based implementation with no sau CLI

What people use it for

  • Posting one video to Douyin, Kuaishou and Xiaohongshu from a script
  • Managing several Douyin or Xiaohongshu accounts with separate --account names
  • Letting an AI agent such as Claude Code run publishing tasks through the packaged skills
  • Publishing long-form articles to Dayu or Xueqiu with the article commands

Frequently asked questions

Is social-auto-upload free?

The project is licensed under MIT, as shown in the repository. The README does not list pricing for the tool itself. Some sponsor links in the README mention paid services, which are separate from the project.

What license does social-auto-upload use?

It uses the MIT licence. The licence is shown in the project header on GitHub.

What do I need to install social-auto-upload?

You need Python 3.10 to 3.12 and the ability to clone a GitHub repository and build it. The install steps are in docs/install.md.

Which platforms does social-auto-upload support?

The README support table includes Douyin, Bilibili, Xiaohongshu, Kuaishou, Tencent video accounts, Baijiahao, Dayu, Alipay Life, Weibo, Hupu, TikTok, Xueqiu, YouTube, Zhihu, Facebook, Facebook Page and Instagram. Capabilities differ by platform, so check the table for video, article, image and scheduling support.

Why does my platform say development or experimental?

The README marks some features as in development or experimental and does not count them as stable. YouTube scheduling and Zhihu scheduling are two examples given in the source.

Is there a point-and-click version or an alternative?

The README centres on the CLI and install documents, so it is not a point-and-click app. The source does not name comparable projects, so this page does not recommend alternatives.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

social-auto-upload suits people who already use Python and the terminal and want to publish the same content to several Chinese and international platforms from scripts or AI agents. If you need a point-and-click app, or you need a platform that is not in the README support table, pick a different tool.

Install options & downloads