LedaChat

Free, open-source Instagram Comment to DM automations (a ManyChat alternative), built on the Adeli API. Hosted at ledachat.com.

When someone comments a keyword on your post, LedaChat replies to their comment and sends them a DM with your link.

Status: the full Comment to DM flow runs against the Adeli API: a matching comment gets a public reply and an opening DM with a button, and a tap sends the final DM with your link. Automations and their stats live in Postgres, or in a local PGlite database if you don't set one up. See docs/PRD.md for the spec and build plan, and docs/brand.md and docs/design.md for the brand and design system.

Run it locally

corepack enable
yarn install
cp apps/web/.env.example apps/web/.env.local   # then set ADELI_API_KEY (see "Get your Adeli API key")
yarn dev

Open http://localhost:3030 and click Connect Instagram. Nothing is mocked. Every Adeli call goes through @adeli/sdk.

Locally ADELI_API_KEY is the only variable you need: the database is PGlite in apps/web/.data, and without Google variables there's no login. apps/web/.env.example lists the optional ones. apps/web/.env.local is the only env file.

The repo is Yarn workspaces:

Path	What	Dev
apps/web	The app: automations, Instagram, webhooks, MCP	yarn dev (port 3030)
apps/landing-page	The static marketing site	yarn dev:landing (port 3031)
packages/ui	Theme tokens and components both apps share

yarn typecheck, yarn lint, yarn test and yarn build run in every workspace.

How it uses Adeli

One LedaChat install uses one Adeli organization, through the API key in ADELI_API_KEY. Every person who signs in gets their own profile in that organization, created when they sign up and named after them (their Google name and email). Their Instagram account, posts and webhook all live on that profile, and LedaChat only ever reads or writes the signed-in person's own profile. People never need an Adeli account of their own: Connect Instagram runs Instagram Login through Adeli.

Deploy to Vercel

1. Import the repo in Vercel and set Root Directory to apps/web. The other defaults work: the vercel-build script applies database migrations, then runs next build. Optionally, set Ignored Build Step to sh scripts/vercel-ignored-build-step.sh so production only redeploys when the app or packages/ui changed. It also skips preview deploys, so leave it empty if you want previews.
2. Add Postgres. In the project's Storage tab, add Neon from the Marketplace and connect it. It sets DATABASE_URL.
3. Create a Google OAuth client in Google Cloud Console (APIs & Services, Credentials, OAuth client ID, type "Web application"). Add the authorized redirect URI https://<your-domain>/api/auth/callback/google.
4. Get an Adeli API key (see "Get your Adeli API key" below).
5. Set the environment variables below, then redeploy.
6. Allowlist the connect redirect. In Adeli, under Settings, OAuth, add https://<your-domain>/connect so people can connect Instagram from LedaChat.
7. Sign in with Google. Everyone who signs in gets their own workspace: their own Adeli profile, Instagram account, automations and webhook. Nobody sees anyone else's. Set ALLOWED_EMAILS to limit who can sign in.
8. Click Connect Instagram. Adeli runs Instagram Login for your profile, then LedaChat registers a webhook just for you.

Variable	Required	Notes
ADELI_API_KEY	Yes	Your Adeli API key, rk_live_.... Every user's profile is created in its organization.
ADELI_API_BASE_URL	No	Leave empty for the hosted Adeli. Set it only if you run your own Adeli.
DATABASE_URL	Yes	Set by the Neon integration. Use the pooled connection string.
BETTER_AUTH_SECRET	Yes	Random, at least 32 characters: openssl rand -base64 32. Also encrypts MCP API tokens, so keep it stable.
GOOGLE_CLIENT_ID	Yes	From the Google OAuth client.
GOOGLE_CLIENT_SECRET	Yes	From the Google OAuth client.
ALLOWED_EMAILS	No	Comma-separated emails that may sign in. Empty: anyone with Google can sign in.
BETTER_AUTH_API_KEY	No	A Better Auth Infrastructure project key. Set it to see and manage your users and sessions in its dashboard.
APP_URL	No	Set it when you use a custom domain. Defaults to the Vercel production domain.

The Adeli API key stays on the server. It's never sent to the browser, and nobody enters a key in the app.

Google sign-in only works on domains registered in the OAuth client, so preview deployments with random URLs can't sign in unless you add them.

Landing page (optional)

Self-hosting needs only the app. The marketing site in apps/landing-page is a second Vercel project: Root Directory apps/landing-page, Ignored Build Step sh scripts/vercel-ignored-build-step.sh, and APP_URL set to the app's address (for example https://app.example.com), which its sign-in links point to. A production build without APP_URL fails.

To test the whole flow against a local Adeli dev server, with a real comment triggering a real DM, follow docs/local-development.md.

Use with Claude (MCP)

LedaChat is also an MCP server at https://<your-domain>/mcp, so Claude can list, create and manage your automations: "make a Comment to DM automation for my latest reel that sends the GUIDE link", "pause everything on that post", "how did last week's automations do".

Open Connect to AI Agent in the app sidebar (/mcp-apis). It has a setup guide for Claude, ChatGPT (and Codex), Cursor, Perplexity and any other MCP client, with your URL filled in.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗