GenAssist
经 AI Skill Hub 精选评估，GenAssist 获评「强烈推荐」。这款Agent工作流在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.0 分，适合有一定技术背景的用户使用。
📚 深度解析
GenAssist 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。
在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 8.0 分，是同类 Agent 工作流中的精选推荐。
📋 工具概览
GenAssist 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
📖 中文文档
GenAssist 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
# 方式一：pip 安装（推荐）
pip install genassist
# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install genassist
# 方式三：从源码安装（获取最新功能）
git clone https://github.com/RitechSolutions/genassist
cd genassist
pip install -e .
# 验证安装
python -c "import genassist; print('安装成功')"
- 访问 GitHub 仓库获取工作流文件
- 在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
- 上传工作流文件
- 按照提示配置必要的环境变量和 API Key
- 运行测试确认流程正常后投入使用
# 命令行使用
genassist --help
# 基本用法
genassist input_file -o output_file
# Python 代码中调用
import genassist
# 示例
result = genassist.process("input")
print(result)
# genassist 配置文件示例（config.yml） app: name: "genassist" debug: false log_level: "INFO" # 运行时指定配置文件 genassist --config config.yml # 或通过环境变量配置 export GENASSIST_API_KEY="your-key" export GENASSIST_OUTPUT_DIR="./output"
简介
<img width="2880" height="2048" alt="GenAssist Infographics" src="https://github.com/user-attachments/assets/4ba0ac3e-7453-4110-8038-02ec6a9becb1" />
Features and architecture
Key features
- User management: authentication, role-based access control and API key management
- AI agents: configure and manage agents with various LLM providers and tools
- Knowledge base: document management with RAG (retrieval-augmented generation)
- Analytics: performance metrics, conversation analysis and KPI tracking
- Conversation management: transcripts, conversation and sentiment analysis
- Audit logging: system activity tracking and change history
Step 3: Fill in the required settings
Open backend/.env in any text editor and set these values:
| Setting | What to put | Why |
|---|---|---|
SEED_ADMIN_PASSWORD | A password of your choice | Your login password for the admin user. It is only applied on the **first** start; see [Reset everything](#everyday-commands). |
FERNET_KEY | A generated key (see below) | Encryption key. The backend **will not start** with the placeholder value. |
DB_PASS | postgres | Must match the database password in docker-compose.dev.yml. |
OPENAI_API_KEY | Your OpenAI key *(optional)* | Needed for agents to respond. |
To generate a FERNET_KEY, run this and paste the output after FERNET_KEY=:
openssl rand -base64 32 | tr '+/' '-_'Then open websocket/.env and set WS_INTERNAL_SECRET to the same value as WS_INTERNAL_SECRET in backend/.env.
Quick start (Docker)
This is the recommended way to run GenAssist locally. Everything runs in Docker, so you don't need Python or Node.js installed.
[!WARNING] This setup is for local development and demos only. Never run it on a server or anywhere reachable from the internet. - Default passwords and keys are public. The database password, the dashboard logins and the test API keys created on first start are visible in this public repository, so anyone can look them up. - Services are reachable from your network. Docker publishes the ports to every device on the same network as your computer, including the database, Redis, the API and the dashboards, not just to you. - Stop GenAssist when you're not using it (see Everyday commands), and avoid running it on public or shared Wi-Fi. - Keep your .env files private. Don't commit them or reuse them for any shared, staging or production environment. Those environments need their own unique passwords and keys.
Step 4: Build and start
docker compose -f docker-compose.dev.yml -p genassist_dev up --build -dWait until the command finishes and every line shows Started, Running or Healthy. On the very first start the backend also creates and fills the database, which can take up to 3–5 minutes before it reports healthy.
Run prebuilt images instead of building from source
Uses the published images from the container registry, which is faster because nothing is built locally. You still need the .env files from steps 2 and 3.
```bash
Local development (without Docker)
For developers working on the code directly. Requires Node.js + npm (frontend) and Python 3.12+ (backend).
| Part | Setup |
|---|---|
| **Frontend** | cd frontend, create .env from .env.template, then follow [frontend/README.md](./frontend/README.md) |
| **Backend** | cd backend, create .env from .env.example, then follow [backend/README.md](./backend/README.md) |
The backend API is then available at http://localhost:8000/api and its docs at http://localhost:8000/docs.
---
Run the chat plugin example
cd example-app npm run dev ```
Step 2: Create the three settings files
The stack reads three .env files. Create them from the provided examples:
cp frontend/.env.template frontend/.env
cp backend/.env.example backend/.env
cp websocket/.env.example websocket/.envOptional extras
Integrations
React plugin
```bash cd plugins/react npm run build
iOS plugin
The iOS plugin lives in plugins/ios. (Build steps to be added.)
---
Troubleshooting
| What you see | Cause | Fix |
|---|---|---|
env file …/frontend/.env not found (or websocket/.env) | A settings file is missing | Repeat [step 2](#step-2-create-the-three-settings-files). |
container genassist-app-dev is unhealthy | The backend failed to start | Read the log (see [Everyday commands](#everyday-commands)) and match the error below. |
Log: Fernet key must be 32 url-safe base64-encoded bytes | FERNET_KEY is still the placeholder | Generate a key ([step 3](#step-3-fill-in-the-required-settings)), then run the *Apply changed .env settings* command. |
Log: password authentication failed | DB_PASS doesn't match the database | Set DB_PASS=postgres, then run *Apply changed .env settings*. |
Browser: **ERR_CONNECTION_RESET** on http://localhost | The app is served on port 8080 | Use **http://localhost:8080**. |
| Login fails right after starting | The backend is still starting | Wait 1–2 minutes. The health check URL should return 200. |
| Login fails with the password you set | The admin user was created on an earlier start with a different password | Reset everything (down -v) and start again. |
| Containers keep stopping or restarting | Docker is out of memory | Increase Docker's memory to 8 GB or more. |
| Agents don't reply | No AI provider key | Add OPENAI_API_KEY (or another provider key) to backend/.env, then run *Apply changed .env settings*. |
Many change detected DEBUG lines in the log | Normal in development mode | Safe to ignore. Use the error-only log command above. |
---
GenAssist是一个高质量的开源AI工作流平台，具有强大的功能和易用性
- 构建多智能体协作系统的 Agent 开发者
- 构建企业知识库 / RAG 检索应用的团队
- 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
- 分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 容器内无法访问宿主机 localhost — 使用 host.docker.internal
- embedding 模型与查询模型不一致导致检索失效
- Python 依赖冲突：建议用 venv / uv 隔离环境
- Docker：genassist 提供官方镜像，docker compose up 一键启动
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 构建多智能体协作系统的 Agent 开发者
- 构建企业知识库 / RAG 检索应用的团队
- 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
- 分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 容器内无法访问宿主机 localhost — 使用 host.docker.internal
- embedding 模型与查询模型不一致导致检索失效
- Python 依赖冲突：建议用 venv / uv 隔离环境
👥 适合人群
🎯 使用场景
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
⚖️ 优点与不足
- +MIT 协议，可免费商用
- +大幅减少重复性人工操作
- +可视化流程，清晰直观
- +可扩展性强，支持复杂场景
- −初始配置和调试需投入一定时间
- −强依赖外部服务的稳定性
- −复杂场景需具备一定技术基础
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：GenAssist 的核心功能完整，质量优秀。对于自动化工程师和运维人员来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | genassist |
| 原始描述 | 开源AI工作流：GenAssist combines orchestration, runtime, analytics, and learning — in one open。⭐61 · Python |
| Topics | aiworkflowconversation-aillm |
| GitHub | https://github.com/RitechSolutions/genassist |
| License | MIT |
| 语言 | Python |
收录时间：2026-06-12 · 更新时间：2026-06-13 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。