gitwtfhub

wtf is instagram-local-rag?

vireonxi-om/instagram-local-rag — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A fully local tool that scrapes a public Instagram account, filters and extracts text from its videos and images, and lets you ask questions against a searchable index of that content.

Mindmap

mindmap
  root((InstagramLocalRAG))
    What it does
      Scrapes public account
      Extracts text from media
      Answers grounded questions
    Tech stack
      Python
      Ollama
      faster-whisper
    Use cases
      Search an educator's posts
      Build a personal Q&A base
      Study a niche topic account
    Audience
      Researchers
      Developers

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

Why would anyone build with this?

REASON 1

Turn a content heavy Instagram account into a private searchable knowledge base for research.

REASON 2

Extract advice from video reels and carousel slides that would otherwise be unsearchable.

REASON 3

Build a grounded question and answer tool over a specific creator's posts with source citations.

REASON 4

Customize the classification prompt to filter a completely different account or topic.

What's in the stack?

PythonOllamafaster-whisperLlama 3.1

How it stacks up

vireonxi-om/instagram-local-rag0-bingwu-0/live-interpreter0cm-labs/tokenizer-benchmark
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audiencedevelopergeneralresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires installing Ollama plus several local models, and reusing a logged in browser cookie for Instagram access.

Use, copy, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

Wtf does this do

instagram-local-rag turns any public Instagram account into a searchable knowledge base that runs entirely on your own computer, with no cloud service and no per-use billing. The idea is that a lot of genuinely useful information lives inside Instagram carousels and reels, but it is hard to search, mixed in with promotional posts and memes, and locked inside images and audio rather than text. This project pulls that content out and makes it something you can ask questions against, with the answers pointing back to the original posts. The pipeline runs in stages. First it scrapes captions and post information from the target account. A local AI model then filters out noise like promotional posts, keeping only the content that matches categories you define. For posts that survive filtering, the tool downloads the actual videos and images, transcribes video audio into text, and uses a vision model to read text out of image slides. All of the extracted text is then merged, split into chunks, and turned into a searchable index. Finally, a question and answer script retrieves the most relevant chunks and produces an answer grounded only in that retrieved text, always citing which posts it came from. Everything runs locally through Ollama, a tool for running AI models on your own machine, along with a speech to text library called faster-whisper that works fine on a regular CPU. Authentication to Instagram works by reusing a cookie from your own browser's existing login, rather than typing or storing a password anywhere. The filtering categories are fully customizable through a plain text prompt file, so the same pipeline can be pointed at any account and topic, not just the study abroad advice account the author originally built it for. The README is upfront that local AI models are good at pulling information out of text but weaker at reasoning over it, so the question and answer step is intentionally strict about only using retrieved context rather than inventing answers. It also includes clear guidance that the tool is meant for personal research on public content, that scraped data should never be shared or committed to the repository, and that Instagram's terms of service and rate limits should be respected. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Walk me through setting up Ollama and the local models this project needs before running the pipeline.
Prompt 2
Explain how this project authenticates to Instagram using a browser cookie instead of a password.
Prompt 3
Help me write a custom classification prompt so this pipeline keeps only posts relevant to my topic.
Prompt 4
Show me how the ask.py script grounds its answers only in retrieved text and cites sources.

Frequently asked questions

wtf is instagram-local-rag?

A fully local tool that scrapes a public Instagram account, filters and extracts text from its videos and images, and lets you ask questions against a searchable index of that content.

What language is instagram-local-rag written in?

Mainly Python. The stack also includes Python, Ollama, faster-whisper.

What license does instagram-local-rag use?

Use, copy, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is instagram-local-rag to set up?

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

Who is instagram-local-rag for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.