difync

Difync

Difync is a command-line tool for downloading Dify.AI workflow DSLs (YAML) from Dify's API to your local filesystem. It allows you to version control your Dify workflows using Git.

Features

• Download workflows from Dify to your local filesystem
• Detect and remove local files for workflows deleted in Dify
• Dry run mode for testing without making changes
• Support for multiple Dify applications
• Detailed logging and statistics
• Environment variables via .env file
• Internationalization support for filenames (including Japanese characters)
• Automatic filename deduplication for apps with identical names

Installation

# Clone the repository
git clone https://github.com/pepabo/difync.git
cd difync

# Copy the sample .env file and edit it with your credentials
cp .env.sample .env
# Edit the .env file with your Dify API credentials
vim .env

# Build the binary
go build -o difync ./cmd/difync

Usage

# Initialize app map and download DSL files
./difync init

# Basic usage (using credentials from .env file)
./difync

# Override base URL from command line
./difync --base-url https://dify.example.com

# Perform a dry run without making any changes
./difync --dry-run

# Specify a custom DSL directory and app map file
./difync --dsl-dir custom/dsl --app-map custom/app_map.json

Configuration

Environment Variables

Difync reads configuration from a .env file in the project root:

# Dify API Configuration
DIFY_BASE_URL=https://cloud.dify.ai
DIFY_EMAIL=your_email_here
DIFY_PASSWORD=your_password_here

# Optional Configuration
# DSL_DIRECTORY=custom/dsl
# APP_MAP_FILE=custom/app_map.json

App Mapping

Difync requires an app mapping file (app_map.json by default) that maps local DSL filenames to Dify application IDs:

{
  "apps": [
    {
      "filename": "my-chatbot.yaml",
      "app_id": "app-xxxxxxxxxxxxxxxx"
    },
    {
      "filename": "my-assistant.yaml",
      "app_id": "app-yyyyyyyyyyyyyyyy"
    }
  ]
}

You can automatically generate this file by running ./difync init, which will download all available apps and create the mapping file.

The DSL files should be placed in the DSL directory (dsl/ by default).

How It Works

Difync downloads workflow files from Dify:

1. It checks the local DSL file's modification time
2. It fetches the Dify application's last update time
3. It compares the two timestamps:
   • If the Dify app is newer, it downloads to local
   • If they're the same or local is newer, it does nothing
4. It also checks if any workflows have been deleted from Dify and removes the corresponding local files

Command-Line Options

Commands:
  init             Initialize app map and download all DSL files

Options:
  --base-url string   Dify API base URL (overrides env: DIFY_BASE_URL)
  --dsl-dir string    Directory containing DSL files (default "dsl")
  --app-map string    Path to app mapping file (default "app_map.json")
  --dry-run           Perform a dry run without making any changes
  --verbose           Enable verbose output

Note: Email and password must be set in environment variables (DIFY_EMAIL and DIFY_PASSWORD).

Development

Testing

Run the tests:

go test ./...

Generate test coverage report:

go test -coverprofile=coverage.out ./...
go tool cover -html=coverage.out -o coverage.html

License

This project is licensed under the MIT License - see the LICENSE file for details.