Yeuoly 739e15f88b feat: support tool plugin id il y a 8 mois
..
.idea 7ae728a9a3 fix nltk averaged_perceptron_tagger download and fix score limit is none (#7582) il y a 10 mois
.vscode e61752bd3a feat/enhance the multi-modal support (#8818) il y a 8 mois
configs dea2962a79 Merge main into feat/plugin il y a 8 mois
constants e61752bd3a feat/enhance the multi-modal support (#8818) il y a 8 mois
contexts e61752bd3a feat/enhance the multi-modal support (#8818) il y a 8 mois
controllers c657378d06 feat: support plugin permission management il y a 8 mois
core 739e15f88b feat: support tool plugin id il y a 8 mois
docker 8dfdb37de3 fix: use LOG_LEVEL for celery startup (#7628) il y a 10 mois
events e61752bd3a feat/enhance the multi-modal support (#8818) il y a 8 mois
extensions 99c8f364ae fix: temp fix for empty redis password il y a 8 mois
factories ef5f476cd6 fix(api): enhance file factory URL handling (#9631) il y a 8 mois
fields e61752bd3a feat/enhance the multi-modal support (#8818) il y a 8 mois
libs dea2962a79 Merge main into feat/plugin il y a 8 mois
migrations c657378d06 feat: support plugin permission management il y a 8 mois
models c657378d06 feat: support plugin permission management il y a 8 mois
schedule 5aabb83f5a update dataset clean rule (#9426) il y a 8 mois
services 5bf86ff66d feat: support latest package identifier il y a 8 mois
tasks 4fd2743efa Feat/new login (#8120) il y a 8 mois
templates 4fd2743efa Feat/new login (#8120) il y a 8 mois
tests dea2962a79 Merge main into feat/plugin il y a 8 mois
.dockerignore 7c83d5ce76 feat: add dockerignore items il y a 9 mois
.env.example bedbd658fe Merge main into fix/chore-fix il y a 8 mois
Dockerfile bedbd658fe Merge main into fix/chore-fix il y a 8 mois
README.md a8134a49c4 fix: poetry installation in CI jobs (#9336) il y a 9 mois
app.py 4d9160ca9f refactor: use dify_config to replace legacy usage of flask app's config (#9089) il y a 8 mois
app_factory.py 4d9160ca9f refactor: use dify_config to replace legacy usage of flask app's config (#9089) il y a 8 mois
commands.py e61752bd3a feat/enhance the multi-modal support (#8818) il y a 8 mois
poetry.lock dea2962a79 Merge main into feat/plugin il y a 8 mois
poetry.toml f62f71a81a build: initial support for poetry build tool (#4513) il y a 1 an
pyproject.toml dea2962a79 Merge main into feat/plugin il y a 8 mois
pytest.ini b933c9d206 chore: move testing env variables from pyproject.toml to pytest.ini (#9019) il y a 9 mois

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