explaingit

vireonxi-om/instagram-local-rag

Analysis updated 2026-05-18

2PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

PythonOllamafaster-whisperLlama 3.1

How does it compare?

vireonxi-om/instagram-local-rag0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedevelopergeneralgeneral

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

How do you get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.