refly

<div align="center"> <h1 align="center" style="border-bottom: none"> <b> <a href="https://www.refly.ai">Refly.AI</a><br> </b> ⭐️ The Open Source Vibe Workflow Platform ⭐️ <br> </h1>

Refly is a pioneering vibe workflow platform designed to solve your most complex challenges. Effortlessly design, build, and reuse intelligent workflows to boost productivity with AI agents and infinite expansion of MCP tools.

🚀 v0.7.1 Released! Now Supporting MCP Store and Background Skill Invocation ⚡️

Refly Cloud · Self-hosting · Forum · Discord · Twitter · Documentation

<p align="center"> <a href="https://refly.ai" target="_blank"> <img alt="Static Badge" src="https://img.shields.io/badge/Product-F04438"></a> <a href="https://refly.ai/pricing" target="_blank"> <img alt="Static Badge" src="https://img.shields.io/badge/free-pricing?logo=free&color=%20%23155EEF&label=pricing&labelColor=%20%23528bff"></a> <a href="https://discord.gg/bWjffrb89h" target="_blank"> <img alt="Discord Chat" src="https://img.shields.io/discord/1323513432686989362?label=chat&logo=discord&logoColor=white&style=flat&color=5865F2"></a> <a href="https://x.com/reflyai" target="_blank"> <img alt="Static Badge" src="https://img.shields.io/twitter/follow/reflyai"></a> <a href="https://www.typescriptlang.org/" target="_blank"> <img alt="TypeScript-version-icon" src="https://img.shields.io/badge/TypeScript-^5.3.3-blue"></a> </p>

<p align="center"> <a href="./README.md"><img alt="README in English" src="https://img.shields.io/badge/English-d9d9d9"></a> <a href="./README_CN.md"><img alt="简体中文版自述文件" src="https://img.shields.io/badge/简体中文-d9d9d9"></a> </p> </div>

Quick Start

Before installing ReflyAI, ensure your machine meets these minimum system requirements:

CPU >= 1 cores

Memory >= 2GB

Self-deploy with Docker

Deploy your own feature-rich, unlimited version of ReflyAI using Docker. Our team is working hard to keep up with the latest versions.

To start deployment:

cd deploy/docker
cp ../../apps/api/.env.example .env # copy the example api env file
docker compose up -d

Self-deploy with Kubernetes

Also, we support deploy ReflyAI to Kubernetes cluster.

To start deployment:

cd deploy/kubernetes

kubectl apply -f refly-deployment.yaml

For the following steps, you can visit Self-deploy Guide for more details.

For core deployment tutorials, environment variable configuration, and FAQs, please refer to 👉 Deployment Guide.

Local Development

View details in CONTRIBUTING.

✨ Key Features

1 🧵 Multi-threaded Conversation System

Built on an innovative multi-threaded architecture that enables parallel management of independent conversation contexts. Implements complex Agentic Workflows through efficient state management and context switching mechanisms, transcending traditional dialogue model limitations.

2 🤖 Multi-model Integration Framework

• Integration with 13+ leading language models, including DeepSeek R1, Claude 3.5 Sonnet, Google Gemini 2.0, and OpenAI O3-mini
• Support for model hybrid scheduling and parallel processing
• Flexible model switching mechanism with unified conversation interface
• Multi-model knowledge base collaboration

3 🎨 Multimodal Processing Capabilities

• File Format Support: 7+ formats including PDF, DOCX, RTF, TXT, MD, HTML, EPUB
• Image Processing: Support for mainstream formats including PNG, JPG, JPEG, BMP, GIF, SVG, WEBP
• Intelligent Batch Processing: Canvas multi-element selection and AI analysis

4 ⚡️ AI-Powered Skill System

Integrating advanced capabilities from Perplexity AI, Stanford Storm, and more:

• Intelligent web-wide search and information aggregation
• Vector database-based knowledge retrieval
• Smart query rewriting and recommendations
• AI-assisted document generation workflow

5 🔍 Context Management System

• Precise temporary knowledge base construction
• Flexible node selection mechanism
• Multi-dimensional context correlation
• Cursor-like intelligent context understanding

6 📚 Knowledge Base Engine

• Support for multi-source heterogeneous data import
• RAG-based semantic retrieval architecture
• Intelligent knowledge graph construction
• Personalized knowledge space management

7 ✂️ Intelligent Content Capture

• One-click content capture from mainstream platforms (Github, Medium, Wikipedia, Arxiv)
• Intelligent content parsing and structuring
• Automatic knowledge classification and tagging
• Deep knowledge base integration

8 📌 Citation System

• Flexible multi-source content referencing
• Intelligent context correlation
• One-click citation generation
• Reference source tracking

9 ✍️ AI-Enhanced Editor

• Real-time Markdown rendering
• AI-assisted content optimization
• Intelligent content analysis
• Notion-like editing experience

10 🎨 Code Artifact Generation

• Generate HTML, SVG, Mermaid diagrams, and React applications
• Smart code structure optimization
• Component-based architecture support
• Real-time code preview and debugging

11 🌐 Website Visualization Engine

• Interactive web page rendering and preview
• Complex concept visualization support
• Dynamic SVG and diagram generation
• Responsive design templates
• Real-time website prototyping
• Integration with modern web frameworks

🛣️ Roadmap

We're continuously improving Refly with exciting new features. For a detailed roadmap, visit our complete roadmap documentation.

• 🎨 Advanced image, audio, and video generation capabilities
• 🎨 Cross-modal content transformation tools
• 💻 High-performance desktop client with improved resource management
• 💻 Enhanced offline capabilities
• 📚 Advanced knowledge organization and visualization tools
• 📚 Collaborative knowledge base features
• 🔌 Open standard for third-party plugin development based on MCP
• 🔌 Plugin marketplace and developer SDK
• 🤖 Autonomous task completion with minimal supervision
• 🤖 Multi-agent collaboration systems
• ⚡️ Visual workflow builder for complex AI-powered processes
• ⚡️ Advanced integration capabilities with external systems and API support
• 🔒 Enhanced security and compliance tools
• 🔒 Advanced team management and analytics

How to Use?

• Cloud
• We've deployed a Refly Cloud version that allows zero-configuration usage, offering all capabilities of the self-hosted version, including free access to GPT-4o-mini and limited trials of GPT-4o and Claude-3.5-Sonnet. Visit https://refly.ai/ to get started.
• Self-hosting Refly Community Edition
• Get started quickly with our Getting Started Guide to run Refly in your environment. For more detailed references and in-depth instructions, please refer to our documentation.
• Refly for enterprise / organizations
• Please contact us at [email protected] for private deployment solutions.

Stay Updated

Star Refly on GitHub to receive instant notifications about new version releases.

Contributing Guidelines

Bug Reports	Feature Requests	Issues/Discussions	ReflyAI Community
Create Bug Report	Submit Feature Request	View GitHub Discussions	Visit ReflyAI Community
Something isn't working as expected	Ideas for new features or improvements	Discuss and raise questions	A place to ask questions, learn, and connect with others

Calling all developers, testers, tech writers and more! Contributions of all types are more than welcome, please check our CONTRIBUTING.md and feel free to browse our GitHub issues to show us what you can do.

For bug reports, feature requests, and other suggestions, you can also create a new issue and choose the most appropriate template to provide feedback.

If you have any questions, feel free to reach out to us. One of the best places to get more information and learn is the ReflyAI Community, where you can connect with other like-minded individuals.

Community and Contact

• GitHub Discussion: Best for sharing feedback and asking questions.
• GitHub Issues: Best for reporting bugs and suggesting features when using ReflyAI. Please refer to our contribution guidelines.
• Discord: Best for sharing your applications and interacting with the community.
• X(Twitter): Best for sharing your applications and staying connected with the community.

Upstream Projects

We would also like to thank the following open-source projects that make ReflyAI possible:

1. LangChain - Library for building AI applications.
2. ReactFlow - Library for building visual workflows.
3. Tiptap - Library for building collaborative editors.
4. Ant Design - UI library.
5. yjs - Provides CRDT foundation for our state management and data sync implementation.
6. React - Library for web and native user interfaces.
7. NestJS - Library for building Node.js servers.
8. Zustand - Primitive and flexible state management for React.
9. Vite - Next generation frontend tooling.
10. TailwindCSS - CSS library for writing beautiful styles.
11. Tanstack Query - Library for frontend request handling.
12. Radix-UI - Library for building accessible React UI.
13. Elasticsearch - Library for building search functionality.
14. Qdrant - Library for building vector search functionality.
15. Resend - Library for building email sending functionality.
16. Other upstream dependencies.

We are deeply grateful to the community for providing such powerful yet simple libraries that allow us to focus more on implementing product logic. We hope that our project will also provide an easier-to-use Vibe Workflow Platform for everyone in the future.

Security Issues

To protect your privacy, please avoid posting security-related issues on GitHub. Instead, send your questions to [email protected], and we will provide you with a more detailed response.

License

This repository is licensed under the ReflyAI Open Source License, which is essentially the Apache 2.0 License with some additional restrictions.