openreply README

README проекта с github.com/diwenne/openreply. Одним файлом markdown: README.md.

OpenReply

Open-sourced ManyChat for Instagram comment-to-DM automation.

License: MIT Stars Built with Next.js

Someone comments LINK on your reel, and OpenReply queues a DM with your link. That is the whole idea. OpenReply watches the comments on your Instagram posts, and when a comment matches a keyword you set, it sends that person a private reply through the official Meta API. You can also post a public reply under the comment at the same time.

OpenReply is free, MIT-licensed software running on your own infrastructure, with no software seat limits or plan caps. Hosting and optional provider costs are separate.

Supported by Zernio. An optional paid Instagram connection provider that lets you avoid creating and reviewing your own Meta app. OpenReply still runs your campaigns, queues, logs, and inbox on your infrastructure. Connect with Zernio, or keep using your own Meta app.

OpenReply is self-hosted. You have to deploy your own copy.

openreply.diwen.dev is a demo of the dashboard, not a service you can sign up for. Creating an account there will never send a DM for you, and there is no hosted plan to upgrade to.

A working instance needs your deployed fork, a public HTTPS URL, PostgreSQL, Redis, a running worker, and an Instagram connection. Choose optional paid Zernio or your own Meta app. docs/setup.md walks through all of it.

If this saves you a subscription or a weekend of building, a star on the repo genuinely helps other people find it.

Why this exists

Comment-to-DM is one feature, but every tool that offers it wants a recurring subscription for it. OpenReply makes that workflow available as software you can inspect, modify, and host yourself.

OpenReply is built around Meta's official Instagram private replies. It does not scrape, it does not automate a browser, and it never asks for an Instagram password. Instagram’s policies, permissions, messaging windows, and rate limits still apply.

Features

How it works

  1. Someone comments on your Instagram post or reel, or DMs you, or replies to your Story.
  2. Your connection provider (direct Meta or Zernio) delivers the event to your OpenReply instance.
  3. OpenReply checks the text against your active campaigns.
  4. On a keyword match, it queues a job.
  5. A background worker sends the private reply, and the public reply if you enabled one.

The web app receives the webhook and serves the dashboard. A separate worker process does the sending, because the send has to survive rate limits and retries. Both talk to the same Postgres and Redis.

Quick start

  1. Choose your Instagram connection. Zernio is recommended if you want to avoid setting up your own Meta app. It is a paid service and sponsor, not a hosted OpenReply plan. Or follow the existing direct Meta setup.
  2. Deploy the app and worker. Both paths need PostgreSQL, Redis, a public HTTPS URL, and email delivery for magic-link sign-in.
  3. Connect an Instagram Business or Creator account in Settings, create a campaign, and test a keyword comment from another account.

Read docs/setup.md for the complete walkthrough, including a provider-aware AI assistant prompt. Existing accounts are never automatically migrated. Check Zernio’s feature limits before choosing.

Moving from ManyChat or another DM tool? Disconnect it from the Instagram account and give OpenReply control of conversations in Meta Business Suite, or button taps in DMs will fail with "not the thread owner". See Migrating from ManyChat.

Deploy the web app

The button creates your web deployment. You still need to configure the database, Redis, email delivery, and a separate always-on worker.

Deploy with Vercel

Run it locally

git clone https://github.com/diwenne/openreply.git
cd openreply
npm install
cp .env.example .env      # then fill in the values, see docs/setup.md
docker-compose up -d      # starts Postgres and Redis
npm run db:generate
npm run db:migrate
npm run dev               # web app on http://localhost:3000
npm run worker            # in a second terminal, this sends the DMs

Two processes, always. npm run dev serves the app and receives webhooks. npm run worker is what actually sends the messages. If comments come in and no DM ever arrives, the worker is the first thing to check.

Full environment variables and the production layout are in docs/setup.md.

Set it up with your AI assistant

If you use Claude Code, Cursor, or a similar tool, an assistant can walk you through either connection path. There is a ready-made prompt in the Set it up with an AI assistant section of the setup guide. Paste it into your assistant inside a clone of this repo, choose your provider before configuring any Meta secrets, and it will walk you through connecting Instagram and going live.

Tech stack

For the complete stack — application libraries, the two runtime processes, and the free services this runs on (Vercel, Neon, Redis Cloud, an Oracle Cloud always-free VM for the worker, Resend, Meta) — see docs/stack.md.

Contributing

Issues and pull requests are welcome. If you hit a Meta quirk that is not in the setup guide, a PR that documents it is worth as much as a code fix, because that is where everyone loses time.

See CONTRIBUTING.md to get started.

Credits

Built and maintained by Diwen Huang.

OpenReply was initially forked from instagram-comment-to-dm by Anish Raj, also MIT licensed, and has been substantially built upon since.

Star History

Star History Chart

Star the repo

If OpenReply is useful to you, star it. It is the simplest way to help the project reach the next person looking for a free way to do this.

License

MIT. See LICENSE.

openreply (diwenne/openreply)

Ищем в базе…

Что это такое?OpenReply — это самостоятельно развертываемая программа с открытым исходным кодом, альтернатива ManyChat для автоматизации в Instagram «от комментария к личному сообщению»: когда кто-то оставляет ключевое слово под вашим постом или рилсом, ему отправляется личное сообщение с вашей ссылкой через официальный API Instagram.
Это облачный сервис или программу нужно развертывать самому?Это программное обеспечение, которое вы развертываете сами; публичный демо-сайт — это лишь предварительный просмотр интерфейса, и тарифного плана с регистрацией на нем нет.
Как его запустить?Разверните веб-приложение и отдельный постоянно работающий процесс воркера, затем подключите аккаунт Instagram Business или Creator в «Настройках» и создайте кампанию. Локально запускайте 'npm run dev' для приложения и 'npm run worker' для отправителя.
Что нужно, чтобы запустить свой экземпляр?Нужны публичный HTTPS-адрес, PostgreSQL, Redis, сервис отправки писем для входа по magic-link и подключение к Instagram — либо через ваше собственное приложение Meta, либо через платного провайдера Zernio.
Подходит ли это для любой автоматизации в Instagram или работает строго по правилам?Программа использует только официальный API Meta для личных ответов и соблюдает лимиты запросов Instagram, окна для сообщений и правила платформы; она не занимается парсингом, не автоматизирует браузер и не обходит никакие ограничения. Она сама ограничивает себя 750 личными ответами в час на аккаунт, а остальные ставит в очередь.
Могу ли я запустить это на своем сервере?Да, оно рассчитано на работу в вашей собственной инфраструктуре, в том числе на бесплатных тарифах, например на виртуальной машине Oracle Cloud Always Free для воркера.
Использует ли это когда-нибудь мой пароль от Instagram или парсит данные?Нет — оно использует только официальный API Instagram от Meta и никогда не запрашивает ваш пароль от Instagram.
Что будет, если человек нажмет на ссылку, но не подпишется на меня?Если вы включите проверку подписки, OpenReply проверит статус подписки через Meta и будет повторно просить подписаться, пока пользователь не подпишется. Но если Instagram не вернет статус подписки, система работает по принципу «fails open»: все равно отправит ссылку, чтобы настоящий подписчик никогда не был заблокирован.
Может ли это также обрабатывать ответы на мои истории в Instagram?Да, те же ключевые кампании могут срабатывать на входящие личные сообщения, а это включает текстовые ответы на истории, поскольку Instagram доставляет их как личные сообщения. Так человек может ответить словом LINK на историю, и никакой пост для этого не нужен.
Нужно ли мне создавать собственное приложение Meta Developer?Можно создать, а можно пропустить этот шаг, воспользовавшись необязательным платным провайдером Zernio, который отвечает за подключение к Instagram, при этом OpenReply по-прежнему запускает ваши кампании, очереди и входящие на вашей собственной инфраструктуре.
Какой стек технологий лежит в основе?Next.js 16 и React 19 для приложения, Prisma 7 с PostgreSQL для данных, BullMQ на Redis для очереди отправки и воркера, Auth.js с Resend для входа по magic-link и Tailwind CSS для интерфейса.
Какие есть похожие проекты?rankme.fast, asobeast, crm, casdoor, os, bisibility, documenso, itsaplan
Автор
diwenne
Размер
1.3 MB
Звёзды
3.3K
Обновлён
КоммитOct 29
Возраст
4 мес
Коммиты · 90 дней