-
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 docker-compose -f docker-compose.middleware.yaml -p dify up -d cd ../api
-
Copy
.env.example
to.env
-
Generate a
SECRET_KEY
in the.env
file.sed -i "/^SECRET_KEY=/c\SECRET_KEY=$(openssl rand -base64 42)" .env
-
If you use Anaconda, create a new environment and activate it
conda create --name dify python=3.10 conda activate dify
-
Install dependencies
pip install -r requirements.txt
-
Run migrate
Before the first launch, migrate the database to the latest version.
flask db upgrade
⚠️ If you encounter problems with jieba, for example> flask db upgrade Error: While importing 'app', an ImportError was raised:
Please run the following command instead.
pip install -r requirements.txt --upgrade --force-reinstall
-
Start backend:
flask run --host 0.0.0.0 --port=5001 --debug
-
Setup your application by visiting http://localhost:5001/console/api/setup or other apis...
-
If you need to debug local async processing, please start the worker service by running
celery -A app.celery worker -P gevent -c 1 --loglevel INFO -Q dataset,generation,mail
. The started celery app handles the async tasks, e.g. dataset importing and documents indexing.
-
Install dependencies for both the backend and the test environment
pip install -r requirements.txt -r requirements-dev.txt
-
Run the tests locally with mocked system environment variables in
tool.pytest_env
section inpyproject.toml
dev/pytest/pytest_all_tests.sh