TiktokAutoUploader

Open source alternative to SocialPilot and Upload-Post

1.2K stars
AGPL-3.0
Active this week
Last commit 1 day ago

Last verified Nov 6, 2026

Automate TikTok video uploads and scheduling from the CLI, Python, TypeScript, or Go via TikTok's web upload API, with multi-account proxy support.

Visit website GitHub1.2K Deploy on Hostinger

Read the full breakdownWho it is for, how it works, trade-offs, the quick start and the FAQ

who it's for

Who TiktokAutoUploader is for#

Marketing engineers automating multi-account TikTok publishing

TiktokAutoUploader handles login-state persistence and per-account proxy routing, the two things that make multi-account TikTok automation fragile at scale. A team managing 10+ accounts can assign each one a residential proxy, store the sessions once, and push videos from a cron job or CI pipeline with no browser UI.

Skip if:

If you need a visual content calendar, approval workflows, or a drag-and-drop scheduler, a managed tool like SocialPilot will be faster to operate for a non-technical team.

Developers building AI-driven TikTok posting agents

The included MCP server exposes upload and scheduling commands to AI agents such as Claude or Cursor. An agent can receive a video path and caption, call TiktokAutoUploader over MCP, and confirm the upload without any custom API glue. The Go binary and TypeScript SDK provide additional integration paths.

Skip if:

If you need to post across multiple platforms beyond TikTok, TiktokAutoUploader covers TikTok only. A multi-platform service like Upload-Post handles cross-platform distribution from a single API call.

Solo creators scheduling videos from the command line

One login per account, one upload command per video, and TikTok-side scheduling up to 30 days out. No browser UI needed after the initial setup. YouTube Shorts URLs are downloaded automatically via yt-dlp, so creators can cross-post directly from a YouTube link.

Skip if:

If you need analytics, comment management, or brand monitoring alongside scheduling, TiktokAutoUploader has no dashboard. It is an upload and scheduling tool only.

the problem

The problem it solves#

Publishing videos to TikTok programmatically has no first-party API. The only paths are Selenium-based browser automation (brittle, frequently breaks when TikTok updates its frontend), unofficial third-party APIs (rate-limited and often disabled without warning), or manual uploads (not scalable for teams running dozens of accounts). The result is that developers building automated TikTok pipelines spend more time maintaining the upload layer than building the actual content workflow.

For teams managing multiple accounts, the problem compounds: running several accounts from one IP is a fast path to flags and bans, so each account needs its own proxy and consistent login state. Most automation scripts do not handle per-account proxy routing, session persistence, or cloud browser support, leaving teams to wire these pieces together by hand or pay for a managed scheduling service at a per-post cost.

how TiktokAutoUploader solves it

How it solves it#

One-command upload via TikTok's web upload API

Sends videos through TikTok's own web upload endpoint, signing each request the same way a logged-in browser does. Unlike Selenium-based alternatives, it needs no browser driver and no unofficial API key. The same upload command works from Python, TypeScript, Go, or the CLI.

Per-account proxy with consistent IP routing

Each account stores its own proxy (HTTP(S) or SOCKS5), which autotok applies to the login, request signing, upload API calls, and video transfer. Running several accounts from one IP is a fast path to flags; this ensures each account always appears from a consistent, separate IP.

Scheduling from 15 minutes to 30 days ahead

TikTok-side scheduling lets you queue a video to publish at a specific time without keeping a server running to trigger it. TikTok supports windows from 15 minutes to 30 days on most accounts (some are capped at 10 days). Post visibility (public or private) and interaction settings (comments, duets, stitches, AI-generated label) are set at upload time. The self-hosted web app removes the time limit entirely.

Python, TypeScript, and Go SDKs

Ships as a Python package on PyPI, a fully typed TypeScript/JavaScript npm package, and a Go library with a standalone binary. The Go binary requires no Python or Node.js and shares saved account sessions with the other packages, so teams can mix languages in the same pipeline without duplicating login state.

MCP server for AI agent integration

An included MCP server lets AI agents (Claude, Cursor, VS Code) trigger uploads and scheduling without custom glue code. The same session and account state used by the CLI is accessible from the MCP interface, so an agent can receive a video path and caption and post it to TikTok in one step.

Cloud browser support via Browserbase or Steel

The login and request-signing browser can run on Browserbase (hosted) or Steel (hosted or self-hosted, open source) instead of locally. Set AUTOTOK_BROWSER=browserbase and an API key; uploads then run headlessly without installing Chromium on the server. Self-hosted Steel is free and open source, available as a Docker image.

strengths · trade-offs

Strengths and trade-offs#

Strengths

No Selenium dependencyMost TikTok upload scripts rely on Selenium or Playwright for every request, which breaks when TikTok updates its frontend. TiktokAutoUploader computes TikTok's anti-bot request signatures in a headless Chromium session but handles the actual upload through the web API directly, making uploads faster and less fragile than full browser automation.
Four-language support from one account storePython, TypeScript, Go, and the CLI all share the same saved account sessions in ~/.autotok/accounts. A session created with the CLI is immediately usable from Python code or the Go binary; there is no account migration or format conversion between language environments.
AGPL-3.0 with no per-post costUnlike SocialPilot or Upload-Post, which charge per post or per account under a managed subscription, TiktokAutoUploader has no per-post pricing. Run it on any server, container, or CI environment for the cost of that compute alone. AGPL-3.0 permits modification and internal commercial use; the restriction is on distributing a modified version as a managed service to others.
Active maintenance with 1,221 stars and 4 open issuesThe repo received its last push on 2026-11-05, with only 4 open issues. 1,221 GitHub stars and 252 forks reflect a broad user base across the Python and TypeScript communities. The low open-issue count suggests the current release is stable.

Trade-offs

-Requires a one-time Chromium download (about 300 MB)Even though uploads bypass Selenium, TikTok's anti-bot signatures still require a headless browser for the signing step. The local path needs about 300 MB for a Chromium download via the install-browser command. Cloud browser options (Browserbase, Steel) avoid this but add an external service dependency or a self-hosted container to maintain.
-AGPL-3.0 restricts managed service redistributionIf you build a hosted, multi-tenant service on top of TiktokAutoUploader and distribute it to others beyond your own internal use, the AGPL-3.0 license requires releasing your source changes. Teams running it for their own accounts internally have no such obligation. This is a real constraint for SaaS builders who want to white-label it.
-TikTok-side scheduling window is 10 to 30 daysTikTok's native scheduler supports a window of 15 minutes to 30 days for most accounts, but some accounts are capped at 10 days. The self-hosted web app works around this with its own queue and no time limit, but adds an extra container to run and maintain.

versus alternatives

TiktokAutoUploader vs alternatives#

TiktokAutoUploader vs SocialPilot

SocialPilot is an agency-focused social media scheduler that handles TikTok bulk video uploads alongside other platforms. TiktokAutoUploader is a developer-focused CLI and SDK targeting TikTok only, designed for programmatic control rather than a visual dashboard.

Feature	TiktokAutoUploader	SocialPilot
License	AGPL-3.0 (self-host)	Proprietary (SaaS)
Self-hosting	Yes	No
Platforms	TikTok	Multi-platform
Per-account proxy	Yes	No
Developer SDK	Python, TypeScript, Go	No
Pricing	Free (self-hosted)	Paid subscription

TiktokAutoUploader is the better choice when you need programmatic control over uploads, per-account proxy management, or integration into a custom CI pipeline or AI agent workflow. SocialPilot is the better choice when you need a visual content calendar, cross-platform publishing, team collaboration, or approval workflows across multiple social networks without writing code.

TiktokAutoUploader vs Upload-Post

Upload-Post is an API-first video upload service that lets developers post to TikTok and other platforms via a single cURL request. Both tools are developer-oriented, but they represent different models: Upload-Post is a managed, multi-platform API service with per-upload billing; TiktokAutoUploader is a self-hosted CLI and SDK for TikTok specifically with no per-post cost.

Feature	TiktokAutoUploader	Upload-Post
License	AGPL-3.0 (self-host)	Proprietary (SaaS)
Self-hosting	Yes	No
Platforms	TikTok	Multi-platform
Per-request cost	None	Per-upload billing
Proxy management	Yes	No

TiktokAutoUploader is the better fit when you need TikTok-only uploads with no per-post cost, full infrastructure control, and per-account proxy routing for multi-account workflows. Upload-Post is worth considering when you need to distribute video to TikTok and several other platforms through a single API endpoint without maintaining any infrastructure.

install · quick start

Quick start#

bash

Install autotok via pip for the CLI and Python SDK, or npm for the TypeScript SDK.
```bash
pip install "autotok[youtube]"
```

tech stack · detected from GitHub

What it's built on#

Languages: GoJavaScriptPythonTypeScript
Frameworks: FastAPIReact
Tooling: esbuild

frequently asked

FAQ#

Does TiktokAutoUploader use TikTok's official API?

No. TikTok's official Content Posting API is restricted and not publicly available for most use cases. TiktokAutoUploader uses TikTok's web upload endpoint, the same one the TikTok website uses when you upload manually in a browser. It signs each request using a headless Chromium session, which is not the same as Selenium automation: Selenium drives a full browser UI, while this tool calls the upload API directly after computing the required signatures.

What languages and runtimes does autotok support?

TiktokAutoUploader ships as a Python package (via uv, pipx, or pip), a fully typed TypeScript/JavaScript npm package, and a standalone Go binary with no Python or Node.js required. All three share the same account session format, so a login done with the CLI is immediately usable from Python code or the Go binary.

Is TiktokAutoUploader licensed for commercial use?

Yes, for running it yourself. AGPL-3.0 permits you to run TiktokAutoUploader on your own servers for internal or commercial purposes, including client work, without any licensing fee. The restriction applies if you distribute a modified version as a managed service to third parties: in that case, AGPL-3.0 requires publishing your source modifications. Using it internally for your own accounts has no such obligation.

Can TiktokAutoUploader run on a Linux server without a local browser?

Yes. Set AUTOTOK_BROWSER=browserbase (Browserbase hosted cloud) or AUTOTOK_BROWSER=steel (Steel Cloud or a self-hosted Steel container). Both options run the login and signing browser remotely, so nothing needs to be installed locally. For the local browser option on a fresh Linux server, running autotok install-browser with the --with-deps flag as root installs Chromium's system libraries.

How does scheduling work, and is there a time limit?

The CLI scheduling uses TikTok's own native scheduler. TikTok supports a window of 15 minutes to 30 days on most accounts; some accounts are capped at 10 days. The self-hosted web app (Docker) adds its own queue with no time limit and removes the TikTok-side scheduling window, but requires running an extra container. For most use cases the native scheduler is sufficient; the web app is for teams that need to queue posts further than 30 days out.

also worth a look

Similar open-source tools#

useSend

Alternative toResend

Self-hosted email platform for transactional and marketing sends.

4,783 GitHub stars
Licence AGPL-3.0

Claude Seo

InMarketing & Growth

SEO audit plugin for Claude Code, 26 skills and 19 agents

26,793 GitHub stars
Licence MIT

Open Feed Sorter

Alternative toSort Feed

Sort any Instagram or TikTok profile by views or outlier score

Licence MIT

FckSignups

InCustomer Support

Open-source tools that work instantly, no signup required

4,557 GitHub stars
Licence GPL-3.0

dograh

Alternative toVapi

Open source voice agent builder with telephony and BYOK AI support

6,027 GitHub stars
Licence BSD-2-Clause

page-agent

Alternative toCopilotKit

AI-powered GUI Agent for your website

29,634 GitHub stars
Licence MIT

by category

Open source tools in these categories#

Marketing & Growth

agency-agents, MoneyPrinterTurbo, MiroFish 590

Developer Tools

REA (Reverse Engineer Anything), Skills for Real Engineers, superpowers

Hostinger

Self-host TiktokAutoUploader on a Hostinger VPS

Keep it running 24/7, even when your laptop is off. A Hostinger VPS gives it a server of its own.

01
Choose a plan
Starts from $6.49/mo
02
Apply
Extra 10% off yearly plans
03
Install TiktokAutoUploader
On a server that stays on
04
Start building
Focus on the app, not the server

Deploy on Hostinger

Inbox Zero

Alternative toSuperhuman

AI email assistant that drafts replies and clears your inbox

12,915 GitHub stars
Licence AGPL-3.0
#Email

rakazo

Alternative toGrok Bot

AI teammates you own: your keys, your model, your machine.

7,028 GitHub stars
Licence Apache-2.0
#AI Agents

SnitchFeed

Live monitoring on LinkedIn, X, Reddit & more. Agentic social listening for startups.

Marketing & Growth

Advertise your product

The projects we add and every new guide. Free, unsubscribe any time.

Find open source alternatives to paid software

TiktokAutoUploader vs SocialPilot

Feature	TiktokAutoUploader	SocialPilot
License	AGPL-3.0 (self-host)	Proprietary (SaaS)
Self-hosting	Yes	No
Platforms	TikTok	Multi-platform
Per-account proxy	Yes	No
Developer SDK	Python, TypeScript, Go	No
Pricing	Free (self-hosted)	Paid subscription

TiktokAutoUploader vs Upload-Post

Feature	TiktokAutoUploader	Upload-Post
License	AGPL-3.0 (self-host)	Proprietary (SaaS)
Self-hosting	Yes	No
Platforms	TikTok	Multi-platform
Per-request cost	None	Per-upload billing
Proxy management	Yes	No