# langgenius/dify · Reposen Release & Migration Intelligence

> Upgrade config layout and apply 6 database migrations. Migrate shared.env and update queues. Migration: High.

## Metadata
- **Repository URL**: https://github.com/langgenius/dify
- **Primary Package**: `dify-client` (PYPI)
- **Categories**: `AI-FRAMEWORK`, `AI-AGENT`
- **Latest Version**: `v1.20.0`
- **Semantic Status**: `BREAKING`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/langgenius/dify/releases.atom

## The Human Context (Plain-English Pitch)
Dify is an open-source LLM app development platform that combines workflow orchestration, RAG knowledge bases, agent capabilities, and observability into a single interface. This release adds comprehensive OpenTelemetry tracing, malware scanning for uploaded knowledge documents, personal access tokens for OpenAPI automation, and shared messaging tool integrations for human-in-the-loop approvals.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
Upgrade config layout and apply 6 database migrations. Migrate shared.env and update queues. Migration: High.

## Breaking Changes & Required Actions
- [BREAKING] `shared.env` is no longer loaded; common settings must be moved to `api-worker.env`.
- [BREAKING] OpenShell shared-volume Home Snapshots and `DIFY_AGENT_OPENSHELL_SHARED_MOUNT_PATH` have been removed.
- [BREAKING] Celery worker subscriptions must include `human_input_delivery` and `human_input_contact_sync` queues.
- Export app and Agent traces to any collector using the new OpenTelemetry provider.
- Scan knowledge base uploads for malware using Cloudmersive, Scanii, OPSWAT, or custom endpoints.
- Authenticate script and CI requests against the Dify OpenAPI using personal access tokens.
- Migrate configuration by moving settings out of `shared.env` into `api-worker.env` and `urls.env`.

## Migration Snippet
```ts
cd dify/docker
docker compose stop -t -1
git checkout 1.20.0
docker compose pull
docker compose up -d
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **Node.js >=24.22.0** [`COMPATIBLE`]: Requires Node.js 24.22.3 or later in the 24.x line for source deployments.

## Zero-Noise Release Timeline
- **v1.20.0** (2026-11-18) [BREAKING]: Upgrade config layout and apply 6 database migrations. Migrate shared.env and update queues. Migration: High.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is langgenius/dify v1.20.0 safe to upgrade in production?
langgenius/dify v1.20.0 is classified as BREAKING (MINOR release). Upgrade config layout and apply 6 database migrations. Migrate shared.env and update queues. Migration: High.

### What breaking changes or compatibility risks exist in langgenius/dify v1.20.0?
`shared.env` is no longer loaded; common settings must be moved to `api-worker.env`. OpenShell shared-volume Home Snapshots and `DIFY_AGENT_OPENSHELL_SHARED_MOUNT_PATH` have been removed. Celery worker subscriptions must include `human_input_delivery` and `human_input_contact_sync` queues.

### What is the bundle size impact of dify-client v1.20.0?
Measured bundle size telemetry is currently unavailable for dify-client v1.20.0; verify build output locally before deploying.

### How do I upgrade dify-client to v1.20.0?
Upgrade dify-client to v1.20.0 by running "pip install dify-client==1.20.0" and applying the migration steps: cd dify/docker docker compose stop -t -1 git checkout 1.20.0 docker compose pull docker compose up -d
