You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gcgj-dify-1.7.0/api
-LAN- b6fdb6c7cf
refactor: migrate direct mail.send usages to EmailI18nService
- Updated mail_enterprise_task.py to use EmailI18nService.send_raw_email()
- Updated queue_monitor_task.py to use EmailI18nService with new QUEUE_MONITOR_ALERT type
- Updated mail_clean_document_notify_task.py to use EmailI18nService with new DOCUMENT_CLEAN_NOTIFY type
- Added send_raw_email() method for backward compatibility with pre-rendered HTML emails
- Added new email types: ENTERPRISE_CUSTOM, QUEUE_MONITOR_ALERT, DOCUMENT_CLEAN_NOTIFY
- Added email template configurations for the new email types
- Removed unused imports (render_template, mail) from refactored files

This change centralizes email handling through EmailI18nService while maintaining
backward compatibility for legacy email sending patterns.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
7 months ago
..
.idea
.vscode
configs enabling vector index prefix name via configuration files (#22661) 7 months ago
constants Support OAuth Integration for Plugin Tools (#22550) 7 months ago
contexts
controllers chore: code improvement for mcp_client and mcp_tools_manage_service (#22645) 7 months ago
core Optimize tencent_vector knowledge base deletion error handling with batch processing support (#22726) 7 months ago
docker
events Fix/replace datetime patterns with naive utc now (#22654) 7 months ago
extensions Fix/replace datetime patterns with naive utc now (#22654) 7 months ago
factories feat: update file manager and file factory implementations (#22704) 7 months ago
fields feat(app): support custom max_active_requests per app (#22073) 7 months ago
libs refactor: migrate direct mail.send usages to EmailI18nService 7 months ago
migrations fix: migrations circle dependency (#22731) 7 months ago
models Increased the character limitation (#22679) 7 months ago
repositories fix: create api workflow run repository error (#22422) 7 months ago
schedule refactor: migrate direct mail.send usages to EmailI18nService 7 months ago
services refactor: remove unused dissolve_tenant static method (#22690) 7 months ago
tasks refactor: migrate direct mail.send usages to EmailI18nService 7 months ago
templates minor typo fix: remove debug code and fix typo (#22539) 7 months ago
tests test: add comprehensive unit tests for AuthType (#22742) 7 months ago
.dockerignore
.env.example enabling vector index prefix name via configuration files (#22661) 7 months ago
.ruff.toml feat: Persist Variables for Enhanced Debugging Workflow (#20699) 8 months ago
Dockerfile chore: Add fonts-noto-cjk dependency for pypdfium2 (#22359) 7 months ago
README.md
app.py
app_factory.py
commands.py Support OAuth Integration for Plugin Tools (#22550) 7 months ago
dify_app.py
mypy.ini Feat/support sendgrid (#21011) 8 months ago
pyproject.toml chore: bump ruff to 0.12.x (#22259) 7 months ago
pytest.ini Refactor/remove db from cycle manager (#20455) 8 months ago
uv.lock chore: bump ruff to 0.12.x (#22259) 7 months ago

README.md

Dify Backend API

Usage

[!IMPORTANT]

In the v1.3.0 release, poetry has been replaced with uv as the package manager for Dify API backend service.

  1. Start the docker-compose stack

    The backend require some middleware, including PostgreSQL, Redis, and Weaviate, which can be started together using docker-compose.

    cd ../docker
    cp middleware.env.example middleware.env
    # change the profile to other vector database if you are not using weaviate
    docker compose -f docker-compose.middleware.yaml --profile weaviate -p dify up -d
    cd ../api
    
  2. Copy .env.example to .env

    cp .env.example .env 
    
  3. Generate a SECRET_KEY in the .env file.

    bash for Linux

    sed -i "/^SECRET_KEY=/c\SECRET_KEY=$(openssl rand -base64 42)" .env
    

    bash for Mac

    secret_key=$(openssl rand -base64 42)
    sed -i '' "/^SECRET_KEY=/c\\
    SECRET_KEY=${secret_key}" .env
    
  4. Create environment.

    Dify API service uses UV to manage dependencies. First, you need to add the uv package manager, if you don't have it already.

    pip install uv
    # Or on macOS
    brew install uv
    
  5. Install dependencies

    uv sync --dev
    
  6. Run migrate

    Before the first launch, migrate the database to the latest version.

    uv run flask db upgrade
    
  7. Start backend

    uv run flask run --host 0.0.0.0 --port=5001 --debug
    
  8. Start Dify web service.

  9. Setup your application by visiting http://localhost:3000.

  10. If you need to handle and debug the async tasks (e.g. dataset importing and documents indexing), please start the worker service.

uv run celery -A app.celery worker -P gevent -c 1 --loglevel INFO -Q dataset,generation,mail,ops_trace,app_deletion

Testing

  1. Install dependencies for both the backend and the test environment

    uv sync --dev
    
  2. Run the tests locally with mocked system environment variables in tool.pytest_env section in pyproject.toml

    uv run -P api bash dev/pytest/pytest_all_tests.sh