Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/onelevenvy/flock
Flock is a low-code platform for rapidly building chatbots, RAG applications, and coordinating multi-agent teams, primarily using LangChain, LangGraph, NextJS, and FastAPI.（Flock 是一个低代码平台，旨在快速构建聊天机器人、RAG 、Muti-Agent应用程序，主要使用 LangChain、LangGraph、NextJS 和 FastAPI。）
https://github.com/onelevenvy/flock
agent chakra-ui crewai fastapi langchain langgraph langgraph-gui llm muti-agent nextjs ollama openai openapi rag react react-flow workflow
Last synced: 3 months ago
JSON representation
Flock is a low-code platform for rapidly building chatbots, RAG applications, and coordinating multi-agent teams, primarily using LangChain, LangGraph, NextJS, and FastAPI.（Flock 是一个低代码平台，旨在快速构建聊天机器人、RAG 、Muti-Agent应用程序，主要使用 LangChain、LangGraph、NextJS 和 FastAPI。）
- Host: GitHub
- URL: https://github.com/onelevenvy/flock
- Owner: Onelevenvy
- License: apache-2.0
- Created: 2024-09-04T01:21:01.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-10-30T00:20:49.000Z (3 months ago)
- Last Synced: 2024-10-30T02:49:57.229Z (3 months ago)
- Topics: agent, chakra-ui, crewai, fastapi, langchain, langgraph, langgraph-gui, llm, muti-agent, nextjs, ollama, openai, openapi, rag, react, react-flow, workflow
- Language: TypeScript
- Homepage:
- Size: 4.14 MB
- Stars: 39
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## 📃 Flock (Flexible Low-code Orchestrating Collaborative-agent Kits)
简体中文 |
English |
日本語 |
Getting Started
> [!NOTE]
>
> ### 🎉 What's New 2024/11/12
>
> - **Intent Recognition Node**: New Intent Recognition node that can automatically identify user input intent based on preset categories, supporting multi-classification routing!
> 
>
> - **CrewAI Node Support**: Now you can leverage CrewAI's powerful multi-agent capabilities in your workflows! Create sophisticated agent teams and orchestrate complex collaborative tasks with ease.
> 
### Flock is a workflow-based low-code platform for rapidly building chatbots, RAG applications, and coordinating multi-agent teams. Built on LangChain and LangGraph, it provides a flexible, low-code orchestrating solution for collaborative agents, supporting chatbots, RAG applications, agents, and multi-agent systems, with the capability for offline operation.
### 🤖️ Overview
### Work Flow
### Node Types and Functions
Flock's workflow system consists of various node types, each serving a specific purpose:
1. Input Node: Processes initial input and converts it into a format the workflow can handle.
2. LLM Node: Utilizes large language models for text generation and processing.
3. Retrieval Node: Fetches relevant information from knowledge bases.
4. Tool Node: Executes specific tasks or operations, extending workflow functionality.
5. Retrieval Tool Node: Combines retrieval capabilities with tool functionality.
6. Intent Recognition Node: Automatically identifies user input intent based on preset categories and routes to different processing flows.
7. Answer Node: Generates final answers or outputs, integrating results from previous nodes.
8. Subgraph Node: Encapsulates a complete sub-workflow, allowing for modular design.
9. Start and End Nodes: Mark the beginning and end of the workflow.
Future planned nodes include:
- Conditional Branch Node (If-Else)
- File Upload Node
- Code Execution Node
- Parameter Extraction Node
These nodes can be combined to create powerful and flexible workflows suitable for various complex business needs and application scenarios.
### Image Tools use
### Knowledge Retrieval
### Human in the loop (human approval or let the LLM rethink or ask human for help)
Inspired by the [StreetLamb](https://github.com/StreetLamb) project and its [tribe](https://github.com/StreetLamb/tribe) project , Flock adopts much of the approach and code.
Building on this foundation, it introduces some new features and directions of its own.
Some of the layout in this project references [Lobe-chat](https://github.com/lobehub/lobe-chat), [Dify](https://github.com/langgenius/dify), and [fastgpt](https://github.com/labring/FastGPT).
They are all excellent open-source projects, thanks🙇.
### 👨💻 Development
Project tech stack: LangChain + LangGraph + React + Next.js + Chakra UI + PostgreSQL
> [!NOTE]
>
> ### 🤖 Model System
>
> Flock supports various model providers and makes it easy to add new ones. Check out our [Models Guide](./docs/Add_New_Model_Providers_Guide.md) to learn about supported models and how to add support for new providers.
> ### 🛠️ Tools System
>
> Flock comes with various built-in tools and supports easy integration of custom tools. Check out our [Tools Guide](./docs/Add_New_Tools_Guide.md) to learn about available tools and how to add your own.
### 💡RoadMap
1 APP
- [x] ChatBot
- [x] SimpleRAG
- [x] Hierarchical Agent
- [x] Sequential Agent
- [x] Work-Flow
- [x] Intent Recognition Node - Automatically identify user input intent and route to different processing flows
- [x] CrewAI Integration
- [ ] More muti-agent ---On Progress
2 Model
- [x] OpenAI
- [x] ZhipuAI
- [x] Siliconflow
- [x] Ollama
- [x] Qwen
- [ ] Xinference
3 Ohters
- [x] Tools Calling
- [x] I18n
- [ ] Langchain Templates
### 🏘️Highlights
- Persistent conversations: Save and maintain chat histories, allowing you to continue conversations.
- Observability: Monitor and track your agents’ performance and outputs in real-time using LangSmith to ensure they operate efficiently.
- Tool Calling: Enable your agents to utilize external tools and APIs.
- Retrieval Augmented Generation: Enable your agents to reason with your internal knowledge base.
- Human-In-The-Loop: Enable human approval before tool calling.
- Open Source Models: Use open-source LLM models such as llama, Qwen and Glm.
- Multi-Tenancy: Manage and support multiple users and teams.
### How to get started
#### 1. Preparation
##### 1.1 Clone the Code
git clone https://github.com/Onelevenvy/flock.git
##### 1.2 Copy Environment Configuration File
```bash
cp .env.example .env
```
##### 1.3 Generate Secret Keys
Some environment variables in the .env file have a default value of changethis.
You have to change them with a secret key, to generate secret keys you can run the following command:
```bash
python -c "import secrets; print(secrets.token_urlsafe(32))"
```
Copy the content and use that as password / secret key. And run that again to generate another secure key.
##### 1.3 Insatll postgres，qdrant,redis
```bash
cd docker
docker compose --env-file ../.env up -d
```
#### 2.Run Backend
##### 2.1 Installation of the basic environment
Server startup requires Python 3.10.x. It is recommended to use pyenv for quick installation of the Python environment.
To install additional Python versions, use pyenv install.
```bash
pyenv install 3.10
```
To switch to the "3.10" Python environment, use the following command:
```bash
pyenv global 3.10
```
Follow these steps :
Navigate to the "backen" directory:
```bash
cd backend
```
activate the environment.
```bash
poetry env use 3.10
poetry install
```
##### 2.2 initiral data
```bash
# Let the DB start
python /app/app/backend_pre_start.py
# Run migrations
alembic upgrade head
# Create initial data in DB
python /app/app/initial_data.py
```
##### 2.3 run unicorn
```bash
uvicorn app.main:app --reload --log-level debug
```
##### 2.4 run celery (Not necessary, unless you want to use the rag function)
```bash
poetry run celery -A app.core.celery_app.celery_app worker --loglevel=debug
```
#### 3.Run Frontend
##### 3.1 Enter the web directory and install the dependencies
```bash
cd web
pnpm install
```
##### 3.2 Start the web service
```bash
cd web
pnpm dev
# or pnpm build then pnpm start
```
## Star History
[](https://star-history.com/#Onelevenvy/flock&Date)