Skip to content

About

FeedFlow: Autonomous AI agent that curates your Instagram feed to match your specific interests via headless Playwright automation. ๐Ÿ† Instagram Customization Hackathon.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

FeedFlow Logo

FeedFlow AI

Take Back Control of Your Feed.

React Native Next.js Python Playwright Supabase


๐Ÿ“– About FeedFlow

FeedFlow is an autonomous ecosystem designed for the Instagram Feed Customization Hackathon.

We realized that users have almost zero direct control over what the algorithm feeds them. FeedFlow solves this by letting you explicitly declare your positive interests (what you want to see) and negative interests (what you don't want to see).

Once configured, our custom-built headless Playwright Automation Engine securely acts on your behalfโ€”automatically liking, saving, and hiding content on Instagram to "train" the algorithm precisely to your preferences.

โœจ Key Features

  • ๐Ÿ“ฑ Cross-Platform Mobile App: Built with React Native and Expo for a native, seamless onboarding experience.
  • ๐Ÿ’ป Next.js Web Dashboard: A stunning, highly-responsive web interface to monitor your mission traces and active curation stats.
  • ๐Ÿค– Headless Automation Engine: A powerful Python + Playwright backend that injects your session cookies to bypass bot-detection and curates your feed autonomously.
  • ๐Ÿ”Œ Chrome Extension Integration: Instantly grab your active session and sync it securely to the engine.
  • ๐Ÿ“Š Real-time Telemetry: Watch the engine work in real-time with a live hacker-style terminal trace.

๐Ÿ—๏ธ Architecture

FeedFlow is divided into three core microservices:

graph TD
    subgraph "Frontend Clients"
        W[Next.js Web Dashboard]
        M[React Native Expo App]
    end

    subgraph "Backend System"
        API[FastAPI Python Engine]
        DB[(Supabase PostgreSQL)]
        P[Headless Playwright Browser]
    end
    
    subgraph "External"
        IG[Instagram Algorithm]
    end

    W -->|Telemetry & Config| API
    M -->|Telemetry & Config| API
    API -->|Logs & User Data| DB
    API -->|Injects Session| P
    P <-->|Autonomously Likes/Saves| IG
    
    style API fill:#3776AB,stroke:#333,stroke-width:2px,color:#fff
    style P fill:#45ba4b,stroke:#333,stroke-width:2px,color:#fff
    style DB fill:#3ECF8E,stroke:#333,stroke-width:2px,color:#000
    style W fill:#000,stroke:#333,stroke-width:2px,color:#fff
    style M fill:#20232A,stroke:#61DAFB,stroke-width:2px,color:#fff
    style IG fill:#E1306C,stroke:#333,stroke-width:2px,color:#fff
Loading
  1. /web-app (Frontend Dashboard)
    • Built with Next.js 15, React, and TailwindCSS.
    • Handles the main user landing page, goal onboarding, and the Mission Trace dashboard.
  2. /mobile-app (React Native Client)
    • Built with Expo SDK 50 and Expo Router.
    • Provides a native mobile experience for users to connect their accounts on the go.
  3. /automation-engine (Python Backend)
    • Built with FastAPI and Playwright.
    • The brains of the operation. It receives the user's positive/negative interests and securely launches a hidden Chromium instance to curate their Instagram feed.

๐Ÿš€ Quick Start Guide

1. Start the Automation Engine

cd automation-engine
pip install -r requirements.txt
playwright install
python run_server.py

The engine will boot up on http://localhost:8000.

2. Launch the Web App

cd web-app
npm install
npm run dev

Access the beautiful web dashboard at http://localhost:3000.

3. Launch the Mobile App

cd mobile-app
npm install
npx expo start

Scan the QR code using Expo Go on your iOS or Android device.


๐Ÿ›ก๏ธ Privacy & Security

FeedFlow uses Cookie Injection via your local machine to securely authenticate with Instagram. We do not store your raw password on our databases. All automation is executed locally or via secure proxies to ensure your account remains safe and unblocked.


Built with โค๏ธ for the Instagram Hackathon.

About

FeedFlow: Autonomous AI agent that curates your Instagram feed to match your specific interests via headless Playwright automation. ๐Ÿ† Instagram Customization Hackathon.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages