git404hub

what is ai-social-browser fr?

blueberriely/ai-social-browser — explained in plain English

Analysis updated 2026-05-18

35PythonAudience · developerComplexity · 4/5LicenseSetup · hard

tl;dr

A shared browser setup that lets a person and an AI agent both control the same logged in Chrome session, so an agent can automate posting and browsing on Twitter and Xiaohongshu without tripping bot detection.

vibe map

mindmap
  root((ai-social-browser))
    What it does
      Shared browser for human and agent
      Automates Twitter and Xiaohongshu
      Returns structured JSON
    Tech stack
      Python
      Playwright
      Chrome
      Cloudflare Tunnel
    Use cases
      Auto post and reply
      Read feed as data
      Remote phone control
    Audience
      Developers with agents
      Automation builders
    Safety
      Account warming
      Rate limits
      Secured tunnel only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automate posting, liking, and replying on Twitter or Xiaohongshu through your own AI agent

VIBE 2

Read a social media feed as structured JSON data for an agent to process

VIBE 3

Run a persistent browser session on a VPS that a person can remotely control from a phone

what's the stack?

PythonPlaywrightChromeuvicornsystemdCloudflare Tunnelxvfb

how it stacks up fr

blueberriely/ai-social-browseralex-nlp/denoiserlanvarnarz/killspam-bot
Stars353535
LanguagePythonPythonPython
Setup difficultyhardhardmoderate
Complexity4/55/53/5
Audiencedeveloperresearcherops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires a VPS, a secured tunnel, and a manually warmed up social media account before automation works safely.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

This project sets up a browser that both a person and an AI agent share, so an AI can post, like, and read on Twitter and Xiaohongshu, a Chinese social platform, without getting flagged as a bot. The core idea is that automation gets caught less often when it uses a real, visible version of Chrome, not a hidden headless one, together with a login session that a human created themselves. The repo runs that visible Chrome on a server, using a virtual screen so it does not need a monitor attached. A person controls it from their phone to log in, solve captchas, and handle anything unusual, while the AI agent sends simple web requests to read the feed, like posts, reply, or post new content. The repo has two main parts. The first, called relay, keeps the shared browser running and streams its screen to a phone so a human can operate it remotely. The second, called actions, turns social media tasks into HTTP commands the AI agent can call, such as feed, read, like, reply, and post, and returns the results as structured data instead of raw web pages. The README stresses that the technique only works if the account itself is treated carefully. A brand new account that starts posting through automation right away gets flagged quickly, while an older account with a history of normal human activity is much safer to automate. It recommends letting a person use the account normally for several days before turning on automation, and even suggests using the same server's network location on a phone occasionally so it looks familiar to the platform. Security warnings are a big part of the documentation. The remote control port and the action service ports have no built in login protection, so they should never be exposed directly to the internet, only reached through a secured tunnel. Default limits on how often the agent can post or interact are kept low, since the project is meant for one person's personal AI agent rather than running many accounts at once or any kind of bulk posting. It is written in Python and licensed under MIT.

prompts (copy fr)

prompt 1
Help me deploy the ai-social-browser relay on a fresh Ubuntu VPS using the setup steps in the README.
prompt 2
Write a Cloudflare Tunnel config that exposes the relay's port 8271 safely for remote phone access.
prompt 3
Show me how to call the twitter-tool actions API to fetch my feed and like a post.
prompt 4
Explain the account warming steps from ai-social-browser that reduce the risk of getting flagged.

Frequently asked questions

what is ai-social-browser fr?

A shared browser setup that lets a person and an AI agent both control the same logged in Chrome session, so an agent can automate posting and browsing on Twitter and Xiaohongshu without tripping bot detection.

What language is ai-social-browser written in?

Mainly Python. The stack also includes Python, Playwright, Chrome.

What license does ai-social-browser use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ai-social-browser to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ai-social-browser for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.