HRiggs/Recipe-AI
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4b4a3591a4999e02641cf867c2a62198886a975e
Recipe-AI/tools/instaloader
History
Hudson Riggs 4b4a3591a4 which
2025-10-28 16:59:20 -04:00
..
download_ig.py
Version One
2025-10-28 14:33:24 -04:00
README.md
Version One
2025-10-28 14:33:24 -04:00
requirements.txt
Version One
2025-10-28 14:33:24 -04:00

README.md

Instaloader Helper

A small wrapper around Instaloader to download a single Instagram post/reel.

Reference project: instaloader/instaloader (MIT) — https://github.com/instaloader/instaloader

Setup

cd tools/instaloader
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Login options

  • Env vars: IG_USERNAME, IG_PASSWORD
  • Or a session file: IG_SESSIONFILE together with --username. Create it via: 
    instaloader --login YOUR_USERNAME
# After successful login, pass the created session file path via IG_SESSIONFILE or --sessionfile

Usage

# In the virtualenv
python download_ig.py --url https://www.instagram.com/p/DPujDRJDNov/ --out ./downloads
# or provide username/password via env
IG_USERNAME=... IG_PASSWORD=... python download_ig.py --url https://www.instagram.com/p/.../ --out ./downloads
# or use a session file
IG_SESSIONFILE=/path/to/sessionfile python download_ig.py --url https://www.instagram.com/reel/.../ --username YOUR_USERNAME
  • Prints the first downloaded .mp4 path on success.
  • Exits with non-zero code if the post is image-only or access is restricted.