Check its license. It has its own license: read it before using it for work.

Is dify still maintained?

Yes, active. Last change today. Latest release 1.19.0, 8 days ago.

Widely used. 161k stars, 3 years old, by an organization. As with any download, get it from the official repo.

gitmanual

Reading the repo

Opening the box…

How to install dify on macOS (langgenius/dify) · gitmanual

How to install on macOS

langgenius/dify

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.

Node.jsVite#agent#agentic-ai#agentic-framework#agentic-workflow

Before you start

Is it free?: Check its licenseIt has its own license: read it before using it for work.
Still maintained?: Yes, activeLast change today. Latest release 1.19.0, 8 days ago.
Can I trust it?: Widely used161k stars, 3 years old, by an organization. As with any download, get it from the official repo.

Difficulty: Involved
Time: 30 min or more
Stars: ★ 160,988
Activity: Updated this month

Saved setup from 47 min ago

Will it work on macOS?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Your system

macOS Windows Linux

Start here

Website ↗dify.aiThe project's own site.

Also: Docs ↗ · In the browser ↗

Heads-upBuilding it yourself? It also needs Redis and 605 settings in .env (92 secret).

Download for macOS

v1.19.0 - Trace Your Workflows, Layer by Layer · 11/4/2026 ↗

difyctl-v1.19.0-darwin-arm64

binary · Apple Silicon · 63.2 MB · 122 downloads · best match

Download

Raw binary — move it onto your PATH.

curl -LO "https://github.com/langgenius/dify/releases/download/1.19.0/difyctl-v1.19.0-darwin-arm64"
chmod +x "difyctl-v1.19.0-darwin-arm64"

Other macOS downloads (1)

difyctl-v1.19.0-darwin-x64

binary · Intel · 70.3 MB · 108 downloads

Download

Raw binary — move it onto your PATH.

curl -LO "https://github.com/langgenius/dify/releases/download/1.19.0/difyctl-v1.19.0-darwin-x64"
chmod +x "difyctl-v1.19.0-darwin-x64"

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 16 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js ^24.22.1runtime
1×Docker tool
1×pnpm pnpm@12.18.0package manager
1×Redis service

605× settings in .env

COMPOSE_PROFILES
DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKENsecret
NEXT_PUBLIC_DEPLOY_ENV
NEXT_PUBLIC_BASE_PATH
CONSOLE_API_URL
NEXT_PUBLIC_API_PREFIX
NEXT_PUBLIC_PUBLIC_API_PREFIX
NEXT_PUBLIC_COOKIE_DOMAIN
NEXT_PUBLIC_SOCKET_URL
DEV_PROXY_TARGET
DEV_PROXY_CF_ACCESS_CLIENT_IDoptional
DEV_PROXY_CF_ACCESS_CLIENT_SECRETsecretoptional
DEV_PROXY_ENTERPRISE_TARGEToptional
DEV_PROXY_PUBLIC_TARGEToptional
DEV_PROXY_HOSToptional
DEV_PROXY_PORToptional
NEXT_PUBLIC_MARKETPLACE_API_PREFIX
NEXT_PUBLIC_MARKETPLACE_URL_PREFIX
NEXT_PUBLIC_SENTRY_DSN
NEXT_TELEMETRY_DISABLED
NEXT_PUBLIC_ENABLE_AGENTATION
NEXT_PUBLIC_UPLOAD_IMAGE_AS_ICON
NEXT_PUBLIC_TEXT_GENERATION_TIMEOUT_MS
TEXT_GENERATION_TIMEOUT_MS
NEXT_PUBLIC_WORKFLOW_GENERATION_TIMEOUT_MS
WORKFLOW_GENERATION_TIMEOUT_MS
NEXT_PUBLIC_CSP_WHITELIST
NEXT_PUBLIC_ALLOW_EMBED
NEXT_PUBLIC_ALLOW_INLINE_STYLES
NEXT_PUBLIC_MARKDOWN_FORM_FIELD_NAME_EXTRA_CHARS
NEXT_PUBLIC_MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH
NEXT_PUBLIC_ALLOW_UNSAFE_DATA_SCHEME
NEXT_PUBLIC_TOP_K_MAX_VALUE
NEXT_PUBLIC_INDEXING_MAX_SEGMENTATION_TOKENS_LENGTHsecret
INDEXING_MAX_SEGMENTATION_TOKENS_LENGTHsecret
NEXT_PUBLIC_LOOP_NODE_MAX_COUNT
NEXT_PUBLIC_MAX_TOOLS_NUM
NEXT_PUBLIC_MAX_PARALLEL_LIMIT
NEXT_PUBLIC_MAX_ITERATIONS_NUM
NEXT_PUBLIC_ENABLE_WEBSITE_JINAREADER
NEXT_PUBLIC_ENABLE_WEBSITE_FIRECRAWL
NEXT_PUBLIC_ENABLE_WEBSITE_WATERCRAWL
NEXT_PUBLIC_ENABLE_SINGLE_DOLLAR_LATEX
NEXT_PUBLIC_ENABLE_FEATURE_PREVIEW
NEXT_PUBLIC_ENABLE_HITL_IM
NEXT_PUBLIC_ENABLE_ACCESS_TOKENsecret
NEXT_PUBLIC_ENABLE_AGENT_V2
NEXT_PUBLIC_ENABLE_AGENT_V2_IN_CHATFLOW
NEXT_PUBLIC_MAX_TREE_DEPTH
NEXT_PUBLIC_AMPLITUDE_API_KEYsecret
NEXT_PUBLIC_COOKIEYES_SITE_KEYsecret
NEXT_PUBLIC_TURNSTILE_SITE_KEYsecret
NEXT_PUBLIC_WEB_PREFIX
NEXT_PUBLIC_BATCH_CONCURRENCY
WEBAPP_ACCESS_PREFLIGHT_PROXY_SECRETsecretoptional
SECRET_KEYsecret
PASSWORD_PEPPERsecretoptional
LANG
LC_ALL
PYTHONIOENCODING

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/langgenius/dify/badge.svg)](https://gitmanual.com/langgenius/dify)

Good to know

Monorepo (workspaces) — install from the repo root.
Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Makefile has a make dev-setup target — it may automate most of these steps.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: api/providers/trace/trace-aliyun/pyproject.toml, api/providers/trace/trace-arize-phoenix/pyproject.toml, api/providers/trace/trace-langfuse/pyproject.toml, api/providers/trace/trace-langsmith/pyproject.toml and 11 more

Details

License: Not detected
Open issues: 1,227
Branch: main

package.json scripts (16)

checkvp run check:cached
check:fixvp run lint:eslint:fix && vp check --fix
devconcurrently -k -n vinext,proxy "vp run dify-web#dev" "vp run dify-web#dev:proxy"
knipknip --workspace web
knip:productionknip --workspace web --production --include files
knip:production-unused-checknode ./packages/tooling/scripts/check-web-production-unused-after-knip-fix.ts
preparevp config
lint:oxlintvp lint
lint:oxlint:fixvp lint --fix
lint:oxlint:quietvp lint --quiet
lint:tailwindTAILWIND_CANONICAL_CLASSES=true vp lint web packages/dify-ui
lint:tailwind:fixTAILWIND_CANONICAL_CLASSES=true vp lint --fix web packages/dify-ui
lint:eslinteslint --concurrency=auto
lint:eslint:fixeslint --fix --concurrency=auto
lint:eslint:quieteslint --quiet --concurrency=auto
type-checktsrs --noEmit

Files we read (16)

.devcontainer/devcontainer.json

.github/workflows/api-tests.yml

.github/workflows/build-push.yml

.github/workflows/cli-tests.yml

.github/workflows/db-migration-test.yml

.github/workflows/dify-agent-tests.yml

.github/workflows/docker-build.yml

CONTRIBUTING.md

Makefile

README.md

api/.env.example

docker/.env.example

e2e/.env.example

package.json

pnpm-workspace.yaml

web/.env.example

15,999 files in the repo

Yes, it installs on your macOS

Start here

Download for macOS

Did you get it running?

Still stuck? Get a written guide

More like dify that run on macOS