{"id":24954053,"url":"https://github.com/supreme-gg-gg/instagram-cli","last_synced_at":"2026-01-26T04:10:41.380Z","repository":{"id":275237704,"uuid":"925501678","full_name":"supreme-gg-gg/instagram-cli","owner":"supreme-gg-gg","description":"The ultimate weapon against brainrot","archived":false,"fork":false,"pushed_at":"2025-03-20T19:52:32.000Z","size":22966,"stargazers_count":47,"open_issues_count":9,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-28T19:51:40.304Z","etag":null,"topics":["brainrot","cli","command-line-tool","curses","curses-ui","instagram","instagram-api","messenger","productivity","python","terminal-ui","tui","typer"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/instagram-cli/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/supreme-gg-gg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-01T02:40:41.000Z","updated_at":"2025-03-28T09:58:35.000Z","dependencies_parsed_at":"2025-03-28T19:49:28.454Z","dependency_job_id":"05e6febc-0df6-4afa-a4b1-81352ef7b24f","html_url":"https://github.com/supreme-gg-gg/instagram-cli","commit_stats":null,"previous_names":["supreme-gg-gg/instagram-cli"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supreme-gg-gg%2Finstagram-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supreme-gg-gg%2Finstagram-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supreme-gg-gg%2Finstagram-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supreme-gg-gg%2Finstagram-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/supreme-gg-gg","download_url":"https://codeload.github.com/supreme-gg-gg/instagram-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247767237,"owners_count":20992548,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["brainrot","cli","command-line-tool","curses","curses-ui","instagram","instagram-api","messenger","productivity","python","terminal-ui","tui","typer"],"created_at":"2025-02-03T04:17:14.879Z","updated_at":"2026-01-26T04:10:41.374Z","avatar_url":"https://github.com/supreme-gg-gg.png","language":"Python","funding_links":[],"categories":["cli","\u003ca name=\"chat\"\u003e\u003c/a\u003eChat and instant messaging","TypeScript","Table of Contents"],"sub_categories":[],"readme":"# Instagram CLI\n\nThe ultimate weapon against brainrot. The fastest, lightest, and most portable Instagram client.\n\n$$\n\\text{Instagram}_{\\text{CLI}} = \\lim_{\\text{screen time} \\to 0} \\text{Productivity} \\to \\infty\n$$\n\n[![npm](https://img.shields.io/npm/v/@i7m/instagram-cli?style=flat-square)](https://www.npmjs.com/package/@i7m/instagram-cli)\n[![downloads](https://img.shields.io/npm/dm/@i7m/instagram-cli?style=flat-square)](https://www.npmjs.com/package/@i7m/instagram-cli)\n![PyPI](https://img.shields.io/pypi/v/instagram-cli)\n[![PyPI Downloads](https://static.pepy.tech/badge/instagram-cli)](https://pepy.tech/projects/instagram-cli)\n[![AUR](https://img.shields.io/aur/version/instagram-cli?label=AUR)](https://aur.archlinux.org/packages/instagram-cli)\n[![GitHub issues](https://img.shields.io/github/issues/supreme-gg-gg/instagram-cli.svg)](https://github.com/supreme-gg-gg/instagram-cli/issues)\n\n\u003c!-- ![Python](https://img.shields.io/pypi/pyversions/instagram-cli) --\u003e\n\nhttps://github.com/user-attachments/assets/fb25cc5f-a868-487d-b853-a7bbe77ba348\n\n\u003e [!WARNING]\n\u003e This project is not affiliated with, authorized, or endorsed by Instagram. This is an independent and unofficial project. Using it might violate Meta's Terms of Service. Use at your own risk.\n\n## Why Instagram CLI?\n\nEmpower yourself to become a 10x Instagrammer by minimizing distractions, enabling 100% keyboard control, and accessing it from any terminal — whether in your VSCode editor or your Linux server. \n\nInstagram CLI allows you to use social media more intentionally -- to stay connected with people you care about rather than being exploited for your attention.\n\n- Chat with your friends without falling into endless brainrot\n- Stay updated with post and stories from people around you\n- Focus on meaningful, intentional conversations and be productive\n- Full keyboard navigation and shortcuts, no mouse, no touchscreens\n- Celebrate the art and simplicity of **terminal UI (TUI)**\n\n## Installation (TypeScript Client)\n\n### NPM\n\nRequires Node.js v20 or higher.\n\n```bash\nnpm install -g @i7m/instagram-cli\n```\n\n### Homebrew (macOS/Linux)\n\n```bash\nbrew tap supreme-gg-gg/tap\nbrew install instagram-cli\n```\n\nThe formula is available [here](https://github.com/supreme-gg-gg/homebrew-tap/blob/main/Formula/instagram-cli.rb).\n\n### Community Packages\n\nThe following packages are supported by the community. The maintainers of Instagram CLI do not provide support for these packages.\n\n#### AUR (Arch Linux)\n\n```bash\nyay -S instagram-cli\n```\n\n#### Snap (Linux)\n\n```bash\nsnapcraft pack\nsudo snap install instagram-cli_1.4.0_amd64.snap --dangerous\nsnap run instagram-cli.instagram-cli\n# OR, since /snap/bin is in PATH\ninstagram-cli\n```\n\nWe welcome contributions to add more installation methods.\n\nFor installation from source, please refer to the [TypeScript Client Documentation](./DEVELOPMENT.md).\n\n## Installation (Python Client)\n\nThe Python client is the original implementation of `instagram-cli` with nostalgic UNIX vibes.\n\n```bash\npip install instagram-cli\n```\n\nNote that Python links to the `instagram` command, while TypeScript links to `instagram-cli`.\n\n\u003e [!CAUTION]\n\u003e We do not recommend using the TypeScript and Python client simultaneously with the same account to reduce the risk of account bans. We recommend using the TypeScript client when possible since it is much less likely to trigger Instagram's anti-bot mechanisms.\n\nFor more information about the Python client, please refer to the [Python Client Documentation](./instagram-py/README.md).\n\n## Commands\n\nThe following commands will be available after installing the package:\n\n```bash\ninstagram-cli                                  # display title art\ninstagram-cli --help                           # view available commands\n\n# Authentication\ninstagram-cli auth login --username            # login with username and password\ninstagram-cli auth logout                      # logout and removes session\ninstagram-cli auth switch \u003cusername\u003e           # switch to another saved account\ninstagram-cli auth whoami                      # display current default user\n\n# Core features\ninstagram-cli chat -u \u003cusername\u003e -t \u003ctitle\u003e    # start chat interface\ninstagram-cli feed                             # view posts from people you follow\ninstagram-cli stories                          # view stories from people you follow (BETA)\ninstagram-cli notify                           # view notifications (inbox, followers, mentions)\n\n# Modify configuration\ninstagram-cli config                           # lists all config\ninstagram-cli config \u003ckey\u003e \u003cvalue\u003e             # set config key to value\ninstagram-cli config edit                      # open config file in editor\n```\n\n\u003e [!TIP]\n\u003e You can easily manage multiple accounts with Instagram CLI!\n\u003e Your login for each account will be saved **locally** and you can switch between them using the `instagram-cli auth switch \u003cusername\u003e` command or run a certain command with a specific account using the `--username` flag.\n\n## Chat Commands\n\nInside the chat interface and after selecting a thread, you can navigate all interface with 100% keyboard support. When messaging, the following commands are available:\n\n```bash\n# Select messages to perform actions\n:select\n:react \u003cemoji | :emoji_name:\u003e\n:reply \u003ctext\u003e\n:unsend\n\n# Media Handling\n:upload \u003cpath-to-image-or-video\u003e\n:download \u003cpath-to-save\u003e # Requires :select first to select message\n\n# Navigation\n:k # go up\n:K # go to top\n:j # go down\n:J # go to bottom\n```\n\n\u003e [!TIP]\n\u003e You can quickly include text files or images in a message by using `#` followed by the file path. For example, `#path/to/file.txt` or `#path/to/image.png`.\n\u003e Use `tab` and `enter` to autocomplete file paths. You can include emojis in messages with `:emoji_name:` e.g. `:thumbsup:` = 👍 (with fuzzy matching).\n\n## Configuration\n\nYou can view and modify configuration with `instagram-cli config`. The configuration file is located at `~/.instagram-cli/config.ts.yaml`. The following are common configuration options:\n\n| Key            | Type   | Default     | Description                                                                                                 |\n| -------------- | ------ | ----------- | ----------------------------------------------------------------------------------------------------------- |\n| image.protocol | string | \"halfBlock\" | Protocol for rendering images. Options: \"ascii\", \"halfBlock\", \"braille\", \"kitty\", \"iterm2\", \"sixel\", or \"\". |\n| feed.feedType  | string | \"list\"      | Layout of feed display. Options: \"timeline\", \"list\", \"\".                                                    |\n\n\u003e [!NOTE]\n\u003e We automatically select the best image protocol based on your terminal. If you experience issues with image rendering, try changing the `image.protocol` setting. Make sure this is supported by your terminal (e.g. `sixel` and `iterm2` protocols won't work in Kitty).\n\n## Contributing\n\nWe welcome contributors! Please see the comprehensive [CONTRIBUTING.md](CONTRIBUTING.md) file for details on how to get started, create issues, and submit pull requests. It is very important that you follow these instructions because we manage two different clients in the same repository. _Instagram CLI is NOT meant to be used for bot-behaviours, we will not accept contributions that add such features._\n\n### Reporting Issues\n\nOccasionally, Instagram may update their API or protocols which can cause certain features to break. If you encounter any issues, please report them on our [GitHub Issues page](https://github.com/supreme-gg-gg/instagram-cli/issues). Make sure to attach the relevant log files located at `~/.instagram-cli/logs/` to help us diagnose and fix the problem quickly. You may want to redact sensitive data like your username for privacy.\n\n### Sister projects\n\nWe contributed the following extensions to the Ink ecosystem for building Terminal UI apps:\n\n- [Ink Picture, Ink-native image component](https://github.com/endernoke/ink-picture)\n- [Wax, Ink routing framework](https://github.com/endernoke/wax).\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=supreme-gg-gg/instagram-cli\u0026type=date\u0026legend=top-left)](https://www.star-history.com/#supreme-gg-gg/instagram-cli\u0026type=date\u0026legend=top-left)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupreme-gg-gg%2Finstagram-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupreme-gg-gg%2Finstagram-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupreme-gg-gg%2Finstagram-cli/lists"}