publik.

How to install chatmany on Windows

What you end up with

chatmany running in your browser, on your own computer. It is free, and it stays free — there is no account, no trial and no subscription at the end of this.

Time
About 45 minutes
Steps
24
Cost
Free

Before you start

These are one-time installs. If you have used PowerShell before, you may have them already — the first step checks.

  1. Install Git

    Run the installer, then reopen PowerShell.

    Open installer

    You know this worked when: Git responds with a version number

  2. Install Node LTS

    Run the LTS installer, then reopen PowerShell.

    Open download

    You know this worked when: Node responds with a version number

Install chatmany

  1. Open PowerShell

    Keep it open beside this page.

    You know this worked when: PowerShell is open

  2. Check Git and Node

    chatmany's deploy tool needs Node 22 or newer.

    Type this into PowerShell, then press Enter.

    git --version
node --version

    You know this worked when: Git and Node respond with version numbers

  3. Copy chatmany to this PC

    Type this into PowerShell, then press Enter.

    cd ~
if (-not (Test-Path chatmany/.git)) {
git clone https://github.com/Blueturboguy07/chatmany.git
}
cd chatmany
git checkout aa0888ffe73e880bb90dbc588665981d9a53d205

    You know this worked when: You are inside the chatmany folder

  4. Install the deploy tool

    A few hundred small packages, including wrangler — Cloudflare's deploy tool.

    Type this into PowerShell, then press Enter.

    npm.cmd install

    You know this worked when: npm finishes without errors

  5. Sign in to Cloudflare

    A browser opens — sign in to your free Cloudflare account and click Allow.

    Type this into PowerShell, then press Enter.

    npx.cmd wrangler login

    You know this worked when: The terminal prints Successfully logged in

  6. Create the database

    Copy the database_id it prints — the next step needs it.

    Type this into PowerShell, then press Enter.

    npx.cmd wrangler d1 create chatmany

    You know this worked when: A database_id is printed

  7. Put the database id in the config

    In wrangler.toml, replace REPLACE-WITH-THE-ID-FROM-wrangler-d1-create with your database_id.

    Type this into PowerShell, then press Enter.

    notepad wrangler.toml

    You know this worked when: wrangler.toml carries your database_id

  8. Set up the database tables

    Type this into PowerShell, then press Enter.

    npm.cmd run db:migrate:remote

    You know this worked when: Three migrations show a check mark

  9. Put chatmany online

    The printed workers.dev address is MY ADDRESS from here on — write it down.

    Type this into PowerShell, then press Enter.

    npx.cmd wrangler deploy

    You know this worked when: A workers.dev address is printed

  10. Tell the config its own address

    In wrangler.toml, set REDIRECT_URI to MY ADDRESS + /auth/callback.

    Type this into PowerShell, then press Enter.

    notepad wrangler.toml

    You know this worked when: REDIRECT_URI is your callback address

  11. Deploy again

    Same command — it now ships the config with your address in it.

    Type this into PowerShell, then press Enter.

    npx.cmd wrangler deploy

    You know this worked when: The deploy finishes again

  12. Set your owner password

    Invent a long random password, paste it when asked, and keep a copy — it is your only login.

    Type this into PowerShell, then press Enter.

    npx.cmd wrangler secret put OWNER_TOKEN

    You know this worked when: wrangler reports the secret was uploaded

  13. Create your Meta app

    On developers.facebook.com: My Apps, Create app, use case Manage messaging & content on Instagram.

    You know this worked when: The new app's dashboard is open

  14. Copy the Instagram app ID and secret

    Use cases, Customize, API setup with Instagram login. Add all required permissions, then copy both.

    You know this worked when: Instagram app ID and secret are in your notes

  15. Register your address with Meta

    On the same page: Set up Instagram business login. Enter MY ADDRESS + /auth/callback and save.

    You know this worked when: The redirect URL is saved

  16. Fill in the app's public pages

    App settings, Basic: set privacy, terms and data deletion to MY ADDRESS + those three pages.

    You know this worked when: Changes saved

  17. Publish the app

    Sidebar, Publish, then the Publish button. The sidebar badge must say Published.

    You know this worked when: The app says Published

  18. Add the Instagram Tester role

    App roles, Roles, Add People, pick Instagram Tester, type your Instagram username, Add.

    You know this worked when: Your username is listed as Instagram Tester

  19. Accept the tester invite

    On instagram.com in a computer browser: Settings, Apps and websites, Tester Invites, Accept.

    You know this worked when: The invite shows as accepted

  20. Give chatmany the Meta credentials

    Run each line, pasting the Instagram app ID for the first and the secret for the second.

    Type this into PowerShell, then press Enter.

    npx.cmd wrangler secret put APP_ID
npx.cmd wrangler secret put APP_SECRET

    You know this worked when: Both secrets report as uploaded

  21. Connect your Instagram account

    Open MY ADDRESS + /auth/authorize, then click Allow on Instagram's permission screen.

    You know this worked when: The page says Connected

  22. Open your dashboard

    Open MY ADDRESS, sign in with your owner password, and build your first automation.

    You know this worked when: The dashboard shows your Instagram handle

If something goes wrong

Nothing here can damage your computer, and every step can be run again safely. If a command fails, the usual cause is the step before it not having finished.

Still stuck? Tell us what happened and we will fix the guide. Include the step number and we can usually reproduce it.

Have a different setup?