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.
- ๐ฑ 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.
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
/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.
/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.
/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.
cd automation-engine
pip install -r requirements.txt
playwright install
python run_server.pyThe engine will boot up on http://localhost:8000.
cd web-app
npm install
npm run devAccess the beautiful web dashboard at http://localhost:3000.
cd mobile-app
npm install
npx expo startScan the QR code using Expo Go on your iOS or Android device.
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.