alexsun/compose-anything

Fork 0

Files

Sun-ZhenXing d536fbc995 feat: add sim & pingap

2025-12-27 11:24:44 +08:00

8.1 KiB

Raw Permalink Blame History

Langflow

Langflow 是一个低代码可视化框架，用于构建 AI 应用。它基于 Python，与任何模型、API 或数据库无关，可轻松构建 RAG 应用、多智能体系统和自定义 AI 工作流。

功能特点

可视化流构建器：拖放界面构建 AI 应用
多模型支持：支持 OpenAI、Anthropic、Google、HuggingFace 等
RAG 组件：内置向量数据库和检索支持
自定义组件：创建您自己的 Python 组件
智能体支持：构建具有记忆和工具的多智能体系统
实时监控：跟踪执行并调试流程
API 集成：用于编程访问的 REST API

快速开始

复制 .env.example 到 .env：
```
copy .env.example .env
```
（可选）编辑 .env 自定义设置：
- 为生产环境生成安全的 LANGFLOW_SECRET_KEY
- 设置 LANGFLOW_AUTO_LOGIN=false 以要求身份验证
- 配置超级用户凭证
- 为 LLM 提供商添加 API 密钥
启动 Langflow：
```
docker compose up -d
```
等待服务就绪（通常需要 1-2 分钟）
访问 Langflow UI：http://localhost:7860
开始构建您的 AI 应用！

默认配置

服务	端口	说明
Langflow	7860	Web UI 和 API
PostgreSQL	5432	数据库（内部）

默认凭证（如果启用了身份验证）：

用户名：langflow
密码：langflow

环境变量

主要环境变量（完整列表请参阅 .env.example）：

变量	说明	默认值
`LANGFLOW_VERSION`	Langflow 镜像版本	`1.1.1`
`LANGFLOW_PORT_OVERRIDE`	UI 的主机端口	`7860`
`POSTGRES_PASSWORD`	数据库密码	`langflow`
`LANGFLOW_AUTO_LOGIN`	自动登录（禁用以启用身份验证）	`true`
`LANGFLOW_SUPERUSER`	超级用户用户名	`langflow`
`LANGFLOW_SUPERUSER_PASSWORD`	超级用户密码	`langflow`
`LANGFLOW_SECRET_KEY`	会话密钥	（空）
`LANGFLOW_COMPONENTS_PATH`	自定义组件目录	（空）
`LANGFLOW_LOAD_FLOWS_PATH`	自动加载流目录	（空）
`TZ`	时区	`UTC`

资源需求

最低要求：

CPU：1 核心
内存：1GB
磁盘：5GB

推荐配置：

CPU：2+ 核心
内存：2GB+
磁盘：20GB+

数据卷

postgres_data：PostgreSQL 数据库数据
langflow_data：Langflow 配置、流和日志

使用 Langflow

构建您的第一个流

访问 UI：http://localhost:7860
点击 "New Flow" 或使用模板
从侧边栏拖动组件到画布
通过在端口之间拖动来连接组件
配置组件参数
点击 "Run" 测试您的流
使用 API 或与您的应用集成

添加 LLM 提供商

要使用外部 LLM 提供商，请配置其 API 密钥：

在 Langflow UI 中，转到 Settings > Global Variables
添加您的 API 密钥（例如，OPENAI_API_KEY、ANTHROPIC_API_KEY）
在您的流组件中引用这些变量

或者，将它们添加到您的 .env 文件并重启：

# LLM API 密钥示例（添加到 .env）
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...

自定义组件

要添加自定义组件：

为您的组件创建一个目录（例如，./custom_components）

更新 .env：

LANGFLOW_COMPONENTS_PATH=/app/langflow/custom_components

在 docker-compose.yaml 中挂载目录：

volumes:
  - ./custom_components:/app/langflow/custom_components

重启 Langflow

自动加载流

要在启动时自动加载流：

将您的流导出为 JSON 文件
创建一个目录（例如，./flows）

更新 .env：

LANGFLOW_LOAD_FLOWS_PATH=/app/langflow/flows

在 docker-compose.yaml 中挂载目录：

volumes:
  - ./flows:/app/langflow/flows

重启 Langflow

API 使用

Langflow 提供 REST API 用于以编程方式运行流。

获取流 ID

在 UI 中打开您的流
流 ID 在 URL 中：http://localhost:7860/flow/{flow_id}

通过 API 运行流

curl -X POST http://localhost:7860/api/v1/run/{flow_id} \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "input_field": "your input value"
    }
  }'

使用身份验证

如果启用了身份验证，首先获取令牌：

# 登录
curl -X POST http://localhost:7860/api/v1/login \
  -H "Content-Type: application/json" \
  -d '{
    "username": "langflow",
    "password": "langflow"
  }'

# 在后续请求中使用令牌
curl -X POST http://localhost:7860/api/v1/run/{flow_id} \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "input_field": "your input value"
    }
  }'

生产部署

对于生产部署：

启用身份验证：

LANGFLOW_AUTO_LOGIN=false
LANGFLOW_SUPERUSER=admin
LANGFLOW_SUPERUSER_PASSWORD=<强密码>

设置密钥：

# 生成安全密钥
python -c "from secrets import token_urlsafe; print(token_urlsafe(32))"

# 添加到 .env
LANGFLOW_SECRET_KEY=<生成的密钥>

使用强数据库密码：
```
POSTGRES_PASSWORD=<强密码>
```
启用 SSL/TLS：使用带有 SSL 证书的反向代理（nginx、traefik）
配置资源限制：根据您的工作负载调整 CPU 和内存限制
备份数据库：定期备份 PostgreSQL 数据卷

故障排除

Langflow 无法启动

查看日志：docker compose logs langflow
确保 PostgreSQL 健康：docker compose ps postgres
验证端口 7860 未被使用

组件未加载

检查自定义组件路径是否正确
确保在自定义组件中安装了 Python 依赖项
检查日志中的组件错误

性能缓慢

在 .env 中增加资源限制
如果内存不足，减少 LANGFLOW_WORKERS
优化您的流（减少不必要的组件）

数据库连接错误

验证 PostgreSQL 正在运行：docker compose ps postgres
检查 .env 中的数据库凭证
确保 LANGFLOW_DATABASE_URL 正确

维护

备份

备份数据卷：

docker compose down
docker run --rm -v compose-anything_postgres_data:/data -v $(pwd):/backup alpine tar czf /backup/postgres-backup.tar.gz -C /data .
docker run --rm -v compose-anything_langflow_data:/data -v $(pwd):/backup alpine tar czf /backup/langflow-backup.tar.gz -C /data .
docker compose up -d

恢复

从备份恢复：

docker compose down
docker run --rm -v compose-anything_postgres_data:/data -v $(pwd):/backup alpine sh -c "cd /data && tar xzf /backup/postgres-backup.tar.gz"
docker run --rm -v compose-anything_langflow_data:/data -v $(pwd):/backup alpine sh -c "cd /data && tar xzf /backup/langflow-backup.tar.gz"
docker compose up -d

升级

升级 Langflow：

在 .env 中更新版本：
```
LANGFLOW_VERSION=1.2.0
```

拉取新镜像并重启：

docker compose pull
docker compose up -d

检查发布说明中的重大更改

常用命令

# 查看日志
docker compose logs -f langflow

# 重启 Langflow
docker compose restart langflow

# 访问 PostgreSQL
docker compose exec postgres psql -U langflow -d langflow

# 检查资源使用
docker stats

# 清理
docker compose down -v  # 警告：删除所有数据

参考资料

许可证

MIT - 查看 LICENSE

8.1 KiB Raw Permalink Blame History Unescape Escape