Yeuoly 276701e1b7 refactor: plugin installation 10 місяців тому
..
.idea 7ae728a9a3 fix nltk averaged_perceptron_tagger download and fix score limit is none (#7582) 1 рік тому
.vscode 0d4753785f chore: remove .idea and .vscode from root path (#7437) 1 рік тому
configs dd551e6ca8 Ruff: reformatter 10 місяців тому
constants 8c51d06222 feat: regenerate in `Chat`, `agent` and `Chatflow` app (#7661) 11 місяців тому
contexts 3571292fbf chore(api): Introduce Ruff Formatter. (#7291) 1 рік тому
controllers 276701e1b7 refactor: plugin installation 10 місяців тому
core 276701e1b7 refactor: plugin installation 10 місяців тому
docker 8dfdb37de3 fix: use LOG_LEVEL for celery startup (#7628) 1 рік тому
events 74f58f29f9 chore: bump ruff to 0.6.8 for fixing violation in SIM910 (#8869) 11 місяців тому
extensions c6b74daa0a Fix/s3 iam add region name (#7819) 10 місяців тому
fields 9d221a5e19 external knowledge api (#8913) 10 місяців тому
libs ae1eeb9b2a Mergin main into fix/chore-fix 10 місяців тому
migrations ae1eeb9b2a Mergin main into fix/chore-fix 10 місяців тому
models ae1eeb9b2a Mergin main into fix/chore-fix 10 місяців тому
schedule 9d221a5e19 external knowledge api (#8913) 10 місяців тому
services 276701e1b7 refactor: plugin installation 10 місяців тому
tasks 9d221a5e19 external knowledge api (#8913) 10 місяців тому
templates 00b4cc3cd4 feat: implement forgot password feature (#5534) 1 рік тому
tests dd551e6ca8 Ruff: reformatter 10 місяців тому
.dockerignore 7c83d5ce76 feat: add dockerignore items 10 місяців тому
.env.example ae1eeb9b2a Mergin main into fix/chore-fix 10 місяців тому
Dockerfile 8236373498 feat: remove unused codes 10 місяців тому
README.md e75c33a561 Enhance Readme Documentation to Clarify the Importance of Celery Service (#8558) 11 місяців тому
app.py f73751843f Feat/implement-refresh-tokens (#9233) 10 місяців тому
commands.py 2ec6ffe478 feat:support baidu vector db (#9185) 10 місяців тому
poetry.lock dd551e6ca8 Ruff: reformatter 10 місяців тому
poetry.toml f62f71a81a build: initial support for poetry build tool (#4513) 1 рік тому
pyproject.toml dd551e6ca8 Ruff: reformatter 10 місяців тому
pytest.ini b933c9d206 chore: move testing env variables from pyproject.toml to pytest.ini (#9019) 10 місяців тому

README.md

Dify Backend API

Usage

[!IMPORTANT] In the v0.6.12 release, we deprecated pip as the package management tool for Dify API Backend service and replaced it with poetry.

  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
  1. Copy .env.example to .env
  2. 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
  1. Create environment.

Dify API service uses Poetry to manage dependencies. You can execute poetry shell to activate the environment.

  1. Install dependencies
   poetry env use 3.10
   poetry install

In case of contributors missing to update dependencies for pyproject.toml, you can perform the following shell instead.

   poetry shell                                               # activate current environment
   poetry add $(cat requirements.txt)           # install dependencies of production and update pyproject.toml
   poetry add $(cat requirements-dev.txt) --group dev    # install dependencies of development and update pyproject.toml
  1. Run migrate

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

   poetry run python -m flask db upgrade
  1. Start backend
   poetry run python -m flask run --host 0.0.0.0 --port=5001 --debug
  1. Start Dify web service.
  2. Setup your application by visiting http://localhost:3000...
  3. If you need to handle and debug the async tasks (e.g. dataset importing and documents indexing), please start the worker service.
   poetry run python -m 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
   poetry install --with dev
  1. Run the tests locally with mocked system environment variables in tool.pytest_env section in pyproject.toml
   cd ../
   poetry run -C api bash dev/pytest/pytest_all_tests.sh