Mission & Scope
The toolkit is not distributed commercially and is maintained by a single operator to streamline uploads to their own TikTok, Instagram Reels, and YouTube Shorts profiles.
VidAutomata never attempts to automate actions that violate platform Terms of Service. Instead, it prepares compliant media packages and relies on official upload APIs or manual review before any publication step.
Core Capabilities
- Narrative Ingestion: Collects user-approved stories and scripts from open communities such as public Reddit threads.
- Content Preparation: Generates editing manifests and timing plans that guide downstream creative tools, ensuring each video asset can be audited and recreated.
- Media Assembly: Coordinates freely licensed or creator-owned background media with narration tracks generated by open source text to speech models trained on open data sets. The text is then aligned using Montreal Forced Aligner
- Account Management: Stores upload tokens for the maintainer’s personal accounts and never shares access with third parties.
- Compliance Logging: Persists full render manifests and publication notes so every upload has traceable provenance.
Technology Overview
The platform is written in Python and FastAPI, organized into modular agents that handle ingestion, manifest management, rendering coordination, and account gateways. All AI components are sourced from permissively licensed open source projects trained on publicly available data sources, ensuring that derivative works remain within acceptable use guidelines.
The UI is a Node.js and React dashboard that allows the maintainer to monitor pipeline status, review pending uploads, and manage account tokens. The AI models are hosted on private infrastructure with no external access; this infrastructure run the "AI bridge" service that the main application calls to perform text-to-speech through Kokoro and Alignment tasks through a private instance of the Montreal Forced Aligner. This instance is not always online, as it is started on a schedule (once a day) to reduce costs. The backend stockpile works for the ai bridge waiting for it to be online.
VidAutomata never uploads content on behalf of other creators or businesses. Every pipeline run is initiated by the maintainer and targets personal channels only. No third-party client access is provided.
Platform API Workflows
Each integration relies on platform-supported endpoints and respects rate limits, review requirements, and content moderation flows. Collapsible summaries below detail how VidAutomata prepares media and calls the respective APIs for each short-form service.
TikTok Upload API
VidAutomata authenticates with a maintainer-issued OAuth token and
calls TikTok's official /v2/post/publish/video/init/
endpoint to register a render. Video chunks are uploaded via the
resumable transfer contract returned by TikTok, and the toolkit waits
for the platform's confirmation before requesting publication. All
metadata (captions, covers, topics) is sourced from the maintainer's
own scripts and stored for auditability.
Meta Reels Graph API
For Instagram and Facebook Reels, the toolkit uses the Graph API's
container creation flow. The maintainer provisions a user access token,
VidAutomata calls /me/media with the Reels upload type,
uploads the video URI provided by Meta, and polls the status until the
creative is ready. A manual confirmation step is required before the
final /me/media_publish call, ensuring human review of
every asset.
YouTube Data API (Shorts)
YouTube uploads rely on a service account token delegated to the
maintainer's channel. VidAutomata prepares a compliant
videos.insert request with category, language, and age
restriction metadata, then sends the file using the official resumable
upload protocol. The job completes only after YouTube responds with a
video ID, at which point the maintainer reviews the processing status
before scheduling the Short.
Safety & Platform Alignment
Platform integrity is central to the toolkit. VidAutomata:
- Uses rate limits and official APIs.
- Requires manual confirmation before any upload, ensuring a human reviews final creatives for policy alignment.
- Avoids scraping private data or bypassing platform security measures.
Governance & Access
This project is a personal tooling initiative. Access to the infrastructure and any related storage is restricted to the maintainer. There is no user registration system, public API, or commercial onboarding flow.
Each upload token is stored securely and rotated regularly. Operational logs are retained for auditability and not shared externally.
Read more about our privacy stance in the Privacy Policy and acceptable use in the Terms of Service.