dify/README.md

165 lines
8.5 KiB
Markdown
Raw Normal View History

2024-04-03 13:39:41 +08:00
[![](./images/GitHub_README_cover.png)](https://dify.ai)
2023-05-15 08:51:32 +08:00
<p align="center">
<a href="./README.md">English</a> |
2023-05-18 23:45:38 +08:00
<a href="./README_CN.md">简体中文</a> |
2023-06-10 18:25:13 +08:00
<a href="./README_JA.md">日本語</a> |
2023-11-18 00:25:26 +08:00
<a href="./README_ES.md">Español</a> |
2023-12-20 21:48:40 +08:00
<a href="./README_KL.md">Klingon</a> |
<a href="./README_FR.md">Français</a>
2023-05-15 08:51:32 +08:00
</p>
2023-11-17 16:31:54 +08:00
<p align="center">
<a href="https://dify.ai" target="_blank">
<img alt="Static Badge" src="https://img.shields.io/badge/AI-Dify?logo=AI&logoColor=%20%23f5f5f5&label=Dify&labelColor=%20%23155EEF&color=%23EAECF0"></a>
<a href="https://discord.gg/FngNHpbcY7" target="_blank">
<img src="https://img.shields.io/discord/1082486657678311454?logo=discord"
alt="chat on Discord"></a>
<a href="https://twitter.com/intent/follow?screen_name=dify_ai" target="_blank">
<img src="https://img.shields.io/twitter/follow/dify_ai?style=social&logo=X"
alt="follow on Twitter"></a>
<a href="https://hub.docker.com/u/langgenius" target="_blank">
<img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/langgenius/dify-web"></a>
</p>
2023-05-15 08:51:32 +08:00
2024-01-24 22:06:37 +08:00
<p align="center">
2024-03-12 18:14:07 +08:00
<a href="https://aws.amazon.com/marketplace/pp/prodview-t22mebxzwjhu6" target="_blank">
📌 Check out Dify Premium on AWS and deploy it to your own AWS VPC with one-click.
2024-01-24 22:06:37 +08:00
</a>
</p>
2023-11-27 14:20:25 +08:00
2024-04-02 17:19:21 +08:00
**Dify** is an open-source LLM app development platform. Dify's intuitive interface combines a RAG pipeline, AI workflow orchestration, agent capabilities, model management, observability features and more, letting you quickly go from prototype to production.
2023-09-12 20:48:35 +08:00
2023-11-15 19:10:17 +08:00
![](./images/demo.png)
2023-09-12 20:48:35 +08:00
2023-08-16 19:26:35 +08:00
2024-01-16 15:12:35 +08:00
## Using our Cloud Services
2023-08-03 16:33:49 +08:00
2024-01-16 15:12:35 +08:00
You can try out [Dify.AI Cloud](https://dify.ai) now. It provides all the capabilities of the self-deployed version, and includes 200 free requests to OpenAI GPT-3.5.
2024-03-12 17:02:46 +08:00
### Looking to purchase via AWS?
Check out [Dify Premium on AWS](https://aws.amazon.com/marketplace/pp/prodview-t22mebxzwjhu6) and deploy it to your own AWS VPC with one-click.
2024-01-16 15:12:35 +08:00
## Dify vs. LangChain vs. Assistants API
2023-08-03 16:33:49 +08:00
2023-11-15 10:45:21 +08:00
| Feature | Dify.AI | Assistants API | LangChain |
|---------|---------|----------------|-----------|
| **Programming Approach** | API-oriented | API-oriented | Python Code-oriented |
2024-01-16 15:12:35 +08:00
| **Ecosystem Strategy** | Open Source | Close Source | Open Source |
2023-11-15 10:45:21 +08:00
| **RAG Engine** | Supported | Supported | Not Supported |
| **Prompt IDE** | Included | Included | None |
2024-01-16 15:12:35 +08:00
| **Supported LLMs** | Rich Variety | OpenAI-only | Rich Variety |
2023-11-15 10:45:21 +08:00
| **Local Deployment** | Supported | Not Supported | Not Applicable |
2023-08-03 16:33:49 +08:00
2024-01-16 15:12:35 +08:00
2023-11-15 10:45:21 +08:00
## Features
2023-08-03 16:33:49 +08:00
2023-11-15 19:10:17 +08:00
![](./images/models.png)
**1. Workflow**: Create and test complex AI workflows on a visual canvas, with pre-built nodes taking advantage of the power of all the following features and beyond.
2023-11-15 19:10:17 +08:00
**2. LLM Support**: Integration with OpenAI's GPT family of models, or the open-source Llama2 family models. In fact, Dify supports mainstream commercial models and open-source models (locally deployed or based on MaaS).
2023-08-03 16:33:49 +08:00
**3. Prompt IDE**: Visual orchestration of applications and services based on LLMs with your team.
2023-08-03 16:33:49 +08:00
**4. RAG Engine**: Includes various RAG capabilities based on full-text indexing or vector database embeddings, allowing direct upload of PDFs, TXTs, and other text formats.
2023-05-15 08:51:32 +08:00
**5. AI Agent**: Based on Function Calling and ReAct, the Agent inference framework allows users to customize tools, what you see is what you get. Dify provides more than a dozen built-in tool calling capabilities, such as Google Search, DELL·E, Stable Diffusion, WolframAlpha, etc.
2024-01-24 22:06:37 +08:00
2023-05-15 08:51:32 +08:00
2023-11-15 10:45:21 +08:00
**5. Continuous Operations**: Monitor and analyze application logs and performance, continuously improving Prompts, datasets, or models using production data.
2023-05-15 08:51:32 +08:00
2023-11-15 20:52:53 +08:00
## Before You Start
2024-01-16 15:12:35 +08:00
**Star us on GitHub, and be instantly notified for new releases!**
2023-12-22 15:05:11 +08:00
![star-us](https://github.com/langgenius/dify/assets/100913391/95f37259-7370-4456-a9f0-0bc01ef8642f)
2023-11-15 20:52:53 +08:00
- [Website](https://dify.ai)
- [Docs](https://docs.dify.ai)
- [Deployment Docs](https://docs.dify.ai/getting-started/install-self-hosted)
- [FAQ](https://docs.dify.ai/getting-started/faq)
2023-11-15 17:26:04 +08:00
2023-05-15 08:51:32 +08:00
## Install the Community Edition
### System Requirements
Before installing Dify, make sure your machine meets the following minimum system requirements:
2023-08-14 22:41:40 +08:00
- CPU >= 2 Core
2023-05-15 08:51:32 +08:00
- RAM >= 4GB
### Quick Start
The easiest way to start the Dify server is to run our [docker-compose.yml](docker/docker-compose.yaml) file. Before running the installation command, make sure that [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/) are installed on your machine:
```bash
cd docker
2023-06-06 20:26:45 +08:00
docker compose up -d
2023-05-15 08:51:32 +08:00
```
After running, you can access the Dify dashboard in your browser at [http://localhost/install](http://localhost/install) and start the initialization installation process.
2023-05-15 08:51:32 +08:00
2024-03-28 13:02:41 +08:00
#### Deploy with Helm Chart
2024-03-28 13:02:41 +08:00
[Helm Chart](https://helm.sh/) version, which allows Dify to be deployed on Kubernetes.
- [Helm Chart by @LeoQuote](https://github.com/douban/charts/tree/master/charts/dify)
- [Helm Chart by @BorisPolonsky](https://github.com/BorisPolonsky/dify-helm)
2023-05-15 08:51:32 +08:00
### Configuration
2023-11-15 17:26:04 +08:00
If you need to customize the configuration, please refer to the comments in our [docker-compose.yml](docker/docker-compose.yaml) file and manually set the environment configuration. After making the changes, please run `docker-compose up -d` again. You can see the full list of environment variables in our [docs](https://docs.dify.ai/getting-started/install-self-hosted/environments).
2023-05-15 08:51:32 +08:00
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=langgenius/dify&type=Date)](https://star-history.com/#langgenius/dify&Date)
2024-01-16 15:12:35 +08:00
## Contributing
2023-06-12 21:14:21 +08:00
2024-01-16 15:12:35 +08:00
For those who'd like to contribute code, see our [Contribution Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md).
2023-06-12 21:14:21 +08:00
2024-01-16 15:12:35 +08:00
At the same time, please consider supporting Dify by sharing it on social media and at events and conferences.
2024-04-02 19:51:02 +08:00
### Projects made by community
- [Chatbot Chrome Extension by @charli117](https://github.com/langgenius/chatbot-chrome-extension)
2024-03-28 13:02:41 +08:00
2024-01-16 15:12:35 +08:00
### Contributors
<a href="https://github.com/langgenius/dify/graphs/contributors">
<img src="https://contrib.rocks/image?repo=langgenius/dify" />
</a>
### Translations
We are looking for contributors to help with translating Dify to languages other than Mandarin or English. If you are interested in helping, please see the [i18n README](https://github.com/langgenius/dify/blob/main/web/i18n/README.md) for more information, and leave us a comment in the `global-users` channel of our [Discord Community Server](https://discord.gg/8Tpq4AcN9c).
2024-01-16 15:12:35 +08:00
## Community & Support
2023-06-12 21:14:21 +08:00
2024-04-06 14:57:07 +08:00
* [Github Discussion](https://github.com/langgenius/dify/discussions). Best for: sharing feedback and checking out our feature roadmap.
* [GitHub Issues](https://github.com/langgenius/dify/issues). Best for: bugs you encounter using Dify.AI, and feature proposals. See our [Contribution Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md).
2024-01-16 15:12:35 +08:00
* [Email Support](mailto:hello@dify.ai?subject=[GitHub]Questions%20About%20Dify). Best for: questions you have about using Dify.AI.
* [Discord](https://discord.gg/FngNHpbcY7). Best for: sharing your applications and hanging out with the community.
* [Twitter](https://twitter.com/dify_ai). Best for: sharing your applications and hanging out with the community.
* [Business Contact](mailto:business@dify.ai?subject=[GitHub]Business%20License%20Inquiry). Best for: business inquiries of licensing Dify.AI for commercial use.
2023-06-12 21:14:21 +08:00
### Direct Meetings
**Help us make Dify better. Reach out directly to us**.
| Point of Contact | Purpose |
| :----------------------------------------------------------: | :----------------------------------------------------------: |
| <a href='https://cal.com/guchenhe/15min' target='_blank'><img src='https://i.postimg.cc/fWBqSmjP/Git-Hub-README-Button-3x.png' border='0' alt='Git-Hub-README-Button-3x' height="60" width="214"/></a> | Product design feedback, user experience discussions, feature planning and roadmaps. |
| <a href='https://cal.com/pinkbanana' target='_blank'><img src='https://i.postimg.cc/LsRTh87D/Git-Hub-README-Button-2x.png' border='0' alt='Git-Hub-README-Button-2x' height="60" width="225"/></a> | Technical support, issues, or feature requests |
2023-11-15 17:26:04 +08:00
## Security Disclosure
2023-05-15 08:51:32 +08:00
To protect your privacy, please avoid posting security issues on GitHub. Instead, send your questions to security@dify.ai and we will provide you with a more detailed answer.
## License
2023-11-15 10:45:21 +08:00
This repository is available under the [Dify Open Source License](LICENSE), which is essentially Apache 2.0 with a few additional restrictions.