dify/AGENTS.md

AGENTS.md

Dify is an open-source platform for building LLM applications, agentic workflows, and RAG pipelines. This monorepo contains the backend API (api/), frontend application (web/), deployment assets (docker/), standalone agent backend (dify-agent/), CLI (cli/), and end-to-end suite (e2e/). Follow the nearest scoped AGENTS.md for the files being changed. Apply its guidance within the user's requested scope; explicit user instructions take precedence over workflow defaults.

Before starting backend development, read the architecture, repositories, SQLAlchemy, and database schema guides.

Repository Gotchas

• Run backend commands through uv run --project api <command>.
• Backend integration tests are CI-only and are not expected to run locally.
• Keep docker/.env.example limited to settings that require manual user configuration. Omit settings whose built-in defaults work unchanged. Put optional and provider-specific settings in the matching docker/envs/*.env.example file; docker/.env overrides those service-specific env files.