Skip to content

masterFuf/taktik-bot

Repository files navigation

Social Media Automation Platform

Instagram, TikTok, YouTube, Threads & Gmail automation via real Android devices. Likes, follows, DMs, scraping, publishing, hashtag & location targeting, AI tools. Built with Python, uiautomator2 & ADB.

GitHub stars GitHub forks License: GPL v3 Python 3.10+ Discord


Website β€’ Documentation β€’ YouTube β€’ Discord β€’ FranΓ§ais


TAKTIK Demo

Desktop app access details are available on the website

See current access details β†’




🎯 What is TAKTIK?

TAKTIK is a comprehensive social media automation platform for Instagram, TikTok, YouTube, Threads and Gmail. It combines a powerful Python automation engine with a premium Desktop application featuring AI-powered tools, real-time analytics, and an intuitive interface.

Open Source Core β€” The Python automation engine is open source under GPLv3

Premium Desktop App β€” Full-featured application with GUI, AI tools, and multi-account management

AI-Powered β€” Generate content, captions, DM responses, and more with integrated AI

Perfect for:

  • Content Creators β€” Automate engagement and grow your audience organically
  • Social Media Managers β€” Manage multiple accounts efficiently from one dashboard
  • Agencies β€” Scale operations with up to 50 devices and advanced workflows
  • Small Businesses β€” Build your brand presence without manual work
  • Marketers β€” Target specific audiences with precision scraping and outreach

✨ Features Overview

πŸ“Έ Instagram

Content Publishing

Feature Description
Posts & Carousels Publish single images or multi-image carousels (manual or AI mode)
Reels Upload and publish Reels (manual or AI mode)
Stories Post Stories to your account (manual or AI mode)
AI Image Generation Create images with AI: text-to-image or image-to-image through the active media provider configuration
AI Caption & Hashtags Auto-generate descriptions and relevant hashtags for your content

Direct Messages

Feature Description
DM Responses Read and reply to incoming DMs (manual or AI mode)
Cold DM / Outreach Send prospecting messages to targeted users (manual or AI mode)

Automation Workflows

Feature Description
Target Followers/Following Interact with followers or following of specific accounts
Hashtag Workflow Engage with posts from targeted hashtags
Post URL Workflow Interact with users who liked a specific post
Feed Workflow Interact with posts in your home feed
Unfollow Workflow Maintenance workflow with customizable parameters

Scraping Workflows

Feature Description
Target Scraping Scrape followers or following from any account
Hashtag Scraping Extract users from hashtag posts
Post URL Scraping Scrape likers from specific posts
Export Export to CSV or XLSX (Desktop app)

Advanced Scraping & Qualification (Desktop App)

Feature Description
Advanced Scraping Combine target, hashtag and post-based scraping data to build prospect datasets
AI Qualification Score and qualify discovered profiles with AI to identify best prospects
Target Search Search all discovered profiles with filters (username, bio, follower count, etc.)

🎡 TikTok (Beta)

Content Publishing

Feature Description
Posts Publish posts to TikTok

Automation Workflows

Feature Description
For You Workflow Interact with videos on the For You page
Target Followers Interact with followers of specific accounts
Hashtag Workflow Engage with content from targeted hashtags
Unfollow Workflow Maintenance workflow for unfollowing

Direct Messages

Feature Description
DM Responses Read and reply to DMs (manual or AI mode)
Cold DM / Outreach Send prospecting messages (manual or AI mode)

Scraping Workflows

Feature Description
Target Scraping Scrape followers from target accounts
Hashtag Scraping Extract users from hashtag content
Export Export to CSV or XLSX with scraping history (Desktop app)

TikTok features are currently in beta and under active development.


▢️ YouTube

Feature Description
Account Login / logout and account management
Upload Publish Shorts and Videos with title, description and visibility (public / unlisted / private)

🧡 Threads & Gmail

Feature Description
Threads Automation Engagement automation on Threads
Gmail Accounts Account login/logout, OTP reading and account scanning (used for account creation flows)

πŸ€– AI Tools

Feature Description
Persona Analysis Screenshot a profile, AI vision analysis, niche classification + relevance score
Smart Comment Context-aware AI-generated comments on posts
Taktik Agent AI-driven multi-step orchestration of workflows
Content Generation AI images (text-to-image / image-to-image), captions and hashtags
Text-to-Speech Voice synthesis for content

AI text/vision flows run through OpenRouter; @fal-ai/client is still used for some media flows.


πŸ–₯️ Desktop App Exclusive Features

Feature Description
Screen Mirroring Real-time device display in the app
Scheduler Create automation patterns linked to devices with visual workflow builder
Scheduler Control Center Manage all active schedulers from one place
AI Scheduler Generation Generate scheduler configurations from natural language prompts
Analytics Dashboard Detailed interaction stats by day/week/month/year for Instagram & TikTok
Session Analytics View session history with interaction counts and details
Scraping History Access all scraping sessions with CSV/XLSX export
Advanced Scraping & AI Qualification Find, filter and score leads with scraping history and AI analysis
Target Search Query discovered profiles with advanced filters
Network & Proxy Network pools, IP/data reset and per-device IP history
Device Groups Group and configure multiple devices
Cartography Lab Atomic-action test bench by surface (feed/post/story/reels/search/profile) with XML + screenshot capture, per-run reports and multi-device comparison
Multi-language Interface available in 10+ languages

πŸš€ Quick Start

Option 1: Desktop Application (Recommended)

The easiest way to use TAKTIK is through the Desktop application:

  1. Sign up at taktik-bot.com
  2. Download the Desktop app for Windows
  3. Connect your Android device or emulator via ADB
  4. Start automating with the visual interface

Option 2: Python CLI (Advanced)

For developers who prefer command-line usage:

# Clone the repository
git clone https://github.com/masterFuf/taktik-bot.git
cd taktik-bot

# Install dependencies
pip install -r requirements.txt

# Launch TAKTIK Bot
python -m taktik

The CLI is primarily maintained for the Desktop app integration. Some features may require updates for standalone use.

Development tests

The Bot test suite is organized by test type, platform and feature family:

tests/unit/database
tests/unit/database/repositories/tiktok
tests/unit/social_media/tiktok/bridges
tests/unit/social_media/tiktok/services
tests/unit/social_media/tiktok/ui
tests/unit/social_media/tiktok/workflows/followers
tests/unit/social_media/tiktok/workflows/publish

Run all unit tests with:

python -m pytest

Local POC and device smoke scripts belong under tests/poc/ and tests/smoke/. They are intentionally ignored because they may contain dumps, screenshots or device-specific experiments.

Requirements

  • Android 10+ device or emulator
  • ADB (Android Debug Bridge) installed
  • Instagram/TikTok app installed on the device (see recommended versions below)
  • Python 3.10+ (for CLI usage)

Recommended App Versions

For optimal compatibility and functionality, use these specific app versions:

App Recommended Version Language
Instagram 410.0.0.53.71 English (required)
TikTok 43.1.4 English (required)

Important: Both Instagram and TikTok must be set to English for all features to work correctly. These versions have been fully tested and verified.

Compatible Devices

TAKTIK works with any Android device or emulator running Android 10 or higher:

  • Real Android devices (recommended for best results)
  • LDPlayer
  • BlueStacks
  • NoxPlayer
  • MEmu
  • Any other Android emulator

Pro tip: Real devices provide the most authentic behavior and lowest detection risk.


πŸ’° Commercial Access

The Python engine in this repository is open source.

The Desktop application, premium tooling and commercial access terms evolve separately from the codebase. For current availability, onboarding and commercial details, refer to the official website:


πŸ“š Documentation

Full documentation available at taktik-bot.com/en/docs

  • Getting Started Guide
  • Configuration Options
  • Workflow Setup
  • Targeting Strategies
  • Troubleshooting

🀝 Community & Support

Join our active community for help, tips, and feature requests:


πŸ”‘ Keywords

instagram bot instagram automation tiktok bot tiktok automation social media automation instagram growth instagram scraper instagram dm bot cold dm instagram marketing ai content generation social media manager instagram followers engagement bot python instagram bot open source bot


πŸ“„ License

This project is licensed under GNU General Public License v3.0 β€” See LICENSE for details.

The Python automation engine is open source. The Desktop application is a commercial product with separate access terms published on the official website.


⚠️ Disclaimer

For educational and research purposes only.

This software is provided as-is. Users must comply with Instagram's and TikTok's Terms of Service. The developers are not responsible for any account restrictions or bans. Use responsibly and at your own risk.


Star this repo to support the project!


Made with care by masterFuf


taktik-bot.com β€’ Discord

About

Instagram & TikTok automation via real Android devices. Likes, follows, DMs, scraping. No API abuse. Built with Python, uiautomator2 & ADB.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages