Skip to main content

Open Nami

Fast terminal social media profile downloader and TUI.
Bulk download photos, videos, stories, and highlights from Instagram, TikTok, Facebook, and X.

npm version PyPI version CI Node version License


Key Features

  • Interactive Terminal UI: Keyboard-driven navigation with auto, dark, and light themes (Ctrl+T).
  • Auto-Provisioned Engines: Automatically downloads standalone gallery-dl and yt-dlp executables into ~/.open-nami/bin/ on first launch if not installed.
  • In-Place Scraper Updates: Run nami -U anytime to fetch the latest scraper engine releases.
  • Four Command Aliases: open-nami, opennami, nami, and on.
  • Targeted Category Extraction: Download photos, videos, stories, highlights, or complete profile archives.
  • Automatic Directory Sorting: Saves to your system Downloads folder under <platform>/<username>/<category>/. Override anytime with -o, --output <dir>.
  • Anti-Bot & Anti-Ban Hardening:
    • TikTok carousels: disables video extraction flags to prevent 403 errors on photo slides.
    • TikTok videos: passes Chrome TLS impersonation (--impersonate chrome) through yt-dlp to clear Akamai WAF challenges.
    • Instagram: throttles GraphQL pagination with jittered intervals (2.0s–2.8s) and downloads directly from Meta CDN edges.
  • Isolated Cookie Sessions: Clones Netscape cookie files to an ephemeral temporary directory (chmod 0600) with automatic cleanup to prevent session corruption.
  • 100% Local & Private: Direct connections between your machine and platform servers. Zero telemetry, zero external tracking servers.

Installation & Quick Start

Installation

# npm (global)
npm install -g open-nami

# pip (Python)
pip install open-nami

# Homebrew (macOS & Linux)
brew install OpenSelena/tap/open-nami

# One-liner script (macOS & Linux)
curl -fsSL https://raw.githubusercontent.com/OpenSelena/open-nami/main/install.sh | sh

# Run without installing
npx open-nami [profile-or-url]

Quick Start

Launch the interactive interface using any alias:

nami
# or
on
# or
open-nami

Jump straight to a profile:

nami https://www.instagram.com/natgeo/
on @taylorswift
nami tt:zachking

Direct headless downloads:

# Photos only
nami @creator --photos

# Videos only
nami tt:creator --videos

# Instagram stories
nami ig:username --stories

# Full profile archive
nami @username --all

# Update engines
nami -U

Hotkeys in TUI

Key Action
[Tab] Paste URL from clipboard
[Enter] Submit URL / Start download
[↑ / ↓] Navigate format options
[^s] (Ctrl+S) Settings (cookies & download directory)
[^t] (Ctrl+T) Cycle theme (auto / light / dark)
[o] Open destination folder in file manager
[Esc] Back to URL input
[^c] (Ctrl+C) Quit

Interface Demo

1. Paste Profile URL

URL Input Screen

2. Select Media Category

Media Target Picker

3. Real-Time Download Progress

Real-time download progress


Documentation

Full guides and technical specifications are available in the docs/ directory:

  • CLI Reference: Command flags, options, exit codes, and non-interactive scripting.
  • Configuration Guide: ~/.open-nami/config.json schema, settings menu, and environment variables.
  • Cookie Authentication: Authenticated downloads for stories, highlights, private profiles, and ephemeral isolation.
  • Anti-Bot Hardening: WAF mitigations, TLS fingerprint impersonation, request jitter, and 429 backoff.
  • Shell Autocompletion: Autocomplete configuration for Bash, Zsh, Fish, and PowerShell.
  • Fair Use Notice: Section 107 copyright principles, personal archiving, and legal disclosures.

License & Inquiries

Open Nami is released under the MIT License.

Metadata

Release files for open-nami 1.9.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for open-nami 1.9.4
File Size Uploaded Provenance Actions
open_nami-1.9.4.tar.gz 425.5 kB With provenance Details for open_nami-1.9.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for open-nami 1.9.4
File Interpreter ABI Platform Actions
open_nami-1.9.4-py3-none-any.whl Python 3 none any Details for open_nami-1.9.4-py3-none-any.whl

Total release size: 855.9 kB

Release files / open_nami-1.9.4.tar.gz

Download URL open_nami-1.9.4.tar.gz
Size 425.5 kB
Tags Source
SHA-256 checksum
How to use checksums
39df074475c2565a8b05edcdaeedfd697ceef56a25bf580ad57e7acc797452bf
BLAKE2b-256 checksum
How to use checksums
e43d2a105ef4a8e4e0d2f00674800447d48ffd09ab9ae70f51f309009389f519
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

Release files / open_nami-1.9.4-py3-none-any.whl

Download URL open_nami-1.9.4-py3-none-any.whl
Size 430.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
13c68fc498bf11972858da859d134b7b913a5f0a9c2b96b9ee7b2f4811d1a806
BLAKE2b-256 checksum
How to use checksums
b6ff97c65d1682ef31a34be20c7550509fc83d5dba5201ba45ef3af462996ffb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

Security for open-nami 1.9.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for open_nami-1.9.4.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.9.4 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page