开源AI助手
经 AI Skill Hub 精选评估，开源AI助手 获评「强烈推荐」。这款Agent工作流在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.0 分，适合有一定技术背景的用户使用。
📚 深度解析
开源AI助手 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。
在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 8.0 分，是同类 Agent 工作流中的精选推荐。
📋 工具概览
开源AI助手 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
📖 中文文档
开源AI助手 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
# 方式一：npm 全局安装 npm install -g openfox # 方式二：npx 直接运行（无需安装） npx openfox --help # 方式三：项目依赖安装 npm install openfox # 方式四：从源码运行 git clone https://github.com/co-l/openfox cd openfox npm install npm start
- 访问 GitHub 仓库获取工作流文件
- 在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
- 上传工作流文件
- 按照提示配置必要的环境变量和 API Key
- 运行测试确认流程正常后投入使用
# 命令行使用
openfox --help
# 基本用法
openfox [options] <input>
# Node.js 代码中使用
const openfox = require('openfox');
const result = await openfox.run(options);
console.log(result);
# openfox 配置说明 # 查看配置选项 openfox --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export OPENFOX_CONFIG="/path/to/config.yml"
OpenFox
Local-LLM-first agentic coding assistant
Autonomous coding agent for local LLMs with contract-driven execution.
Session — Criteria tracking, tool calls, and streaming responses 
Providers — Local LLM backend configuration 
Workflows — Contract-driven execution pipeline 
What's New in 2.0
- Multi-Turn Agent Engine — Completely rewritten agent loop with EventStore as single source of truth. All modes (builder, planner, verifier, sub-agents, compaction) run through the same unified loop.
- Provider Dialog — Comprehensive provider configuration UI with thinking mode (
reasoningEffort), editable kwargs, profile defaults, and preset management. - Auto-Retry Patterns — Replace the old XML protection toggle with configurable pattern matching. Define your own retry triggers in settings.
- Unified Image Handling — Automatic vision model fallback for non-vision models. Images are described before each turn so any model can "see" them.
- Session Metadata — Unified
session_metadatatool replaces separate criterion/todo tools. Interactive criteria editor with CRUD and agent badges. - Workflow Sub-Groups — Run individual workflow steps in isolation. New code review phase in the build-verify pipeline.
- Parallel
edit_fileSafety — Per-file mutex prevents race conditions when editing multiple files simultaneously. - Firefox Support — Custom thin scrollbars with hover behavior, cross-browser compatible.
Features
- Plan → Builder Workflow: Interactive task breakdown followed by autonomous implementation
- Contract-Driven Execution: Acceptance criteria serve as immutable contract
- Workflows: Declarative multi-step pipelines (agent turns, sub-agents, shell commands, user gates) with conditional transitions. File format and authoring reference: docs/WORKFLOWS.md
- Iterative Verification: Agent loops until all criteria pass
- LSP Integration: Immediate feedback on code validity
- Real-Time Metrics: Prefill time, generation speed, context usage
Requirements
- Node.js >= 24.0.0
- Local LLM backend with OpenAI-compatible API:
- vLLM
- sglang
- ollama
- llamacpp
Quick Start
npm i -g openfox
openfoxOn first run, OpenFox automatically detects your local LLM backend (vLLM, sglang, ollama, llamacpp) and configures itself.
Screenshots
Homepage — Project overview and session history 
Project Selected — Active session with context stats 
Stats — Prefill time, generation speed, token usage 
Terminal — Integrated terminal for running commands 
Notifications — Event log and system messages 
Agents — Sub-agent management and execution 
General Instructions — Global custom instructions 
Vision Fallback — Image processing configuration 
Show current configuration
openfox config
CLI Options
| Option | Description | Default |
|---|---|---|
-p, --port <number> | Specify server port | 10369 |
--no-browser | Don't open browser on start | Opens browser |
-h, --help | Show help message | - |
-v, --version | Show version number | - |
Environment Variables
| Variable | Default | Description |
|---|---|---|
OPENFOX_LLM_URL | http://localhost:8000/v1 | LLM API base URL |
OPENFOX_VLLM_URL | — | Deprecated alias for OPENFOX_LLM_URL |
OPENFOX_BACKEND | unknown | Backend type: vllm, sglang, ollama, llamacpp, unknown |
OPENFOX_BASE_PATH | / | Web app base path for subpath deployments (e.g. /openfox/) |
OPENFOX_MODEL_NAME | '' | Override default model name |
OPENFOX_MAX_CONTEXT | 200000 | Max context window in tokens |
OPENFOX_LLM_TIMEOUT | 300000 | LLM request timeout in ms |
OPENFOX_LLM_IDLE_TIMEOUT | 300000 | LLM stream idle timeout in ms |
OPENFOX_PORT | 10369 | Server listen port |
OPENFOX_HOST | 127.0.0.1 | Server bind host |
OPENFOX_PUBLIC_URL | — | Public origin used to build the MCP OAuth redirect URI |
OPENFOX_WORKDIR | cwd | Working directory |
OPENFOX_DB_PATH | ./openfox.db | SQLite database path |
OPENFOX_LOG_LEVEL | info | Log level: debug, info, warn, error |
OPENFOX_REASONING_EFFORT | — | Reasoning effort (e.g. none, low, medium, high) |
OPENFOX_DEV | false | Enable dev mode |
OPENFOX_MODE | production | Force mode: production, development, test |
OPENFOX_SERVICE | false | Run as systemd service (suppresses browser open) |
OPENFOX_GIT_POLL_INTERVAL | 10000 | Git status poll interval in ms |
OPENFOX_DISABLE_AUTO_SESSION_TITLE | false | Disable automatic session title generation |
CLI Commands
```bash
Plugins
OpenFox supports provider plugins loaded from the plugins directory inside its configuration folder. Plugins can add authentication methods, transports, provider presets, and model discovery without adding provider-specific code to the OpenFox core.
You can install the plugin manually or directly from the UI.
Default plugin directories:
- macOS:
~/Library/Application Support/openfox/plugins - Linux:
${XDG_CONFIG_HOME:-~/.config}/openfox/plugins - Windows:
%APPDATA%\openfox\plugins
Restart OpenFox after installing or updating a plugin.
- To authenticate with a ChatGPT Plus or Pro account, you can install the
openfox-chatgptplugin. - To authenticate with a Github copilot account, you can install the
openfox-github-copilotplugin. - To authenticate with a Google Antigravity account, you can install the
openfox-google-antigravityplugin. - To authenticate with an X (xAI) SuperGrok subscription, you can install the
openfox-xai-supergrokplugin. - To use free OpenRouter models, you can install the
openfox-openrouter-freeplugin. - To use free OpenCode models, you can install the
openfox-opencode-freeplugin.
高质量的开源AI工作流项目
- 构建多智能体协作系统的 Agent 开发者
- 本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
- CLI：直接 npm install -g / pip install，命令行调用
- 本地部署：CPU 8GB 起，GPU 推荐 16GB+ 显存
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 构建多智能体协作系统的 Agent 开发者
- 本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 显存不足直接 OOM — 优先降低 context 或换更小的量化模型
👥 适合人群
🎯 使用场景
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
⚖️ 优点与不足
- +大幅减少重复性人工操作
- +可视化流程，清晰直观
- +可扩展性强，支持复杂场景
- −未明确开源协议，商用场景需谨慎评估
- −初始配置和调试需投入一定时间
- −强依赖外部服务的稳定性
- −复杂场景需具备一定技术基础
该工具未明确声明开源协议，商业使用前请联系原作者确认授权范围，避免侵权风险。
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：开源AI助手 的核心功能完整，质量优秀。对于自动化工程师和运维人员来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | openfox |
| 原始描述 | 开源AI工作流：Local-LLM-first agentic coding assistant, with everything you need out of the bo。⭐11 · TypeScript |
| Topics | AI工作流TypeScript |
| GitHub | https://github.com/co-l/openfox |
| 语言 | TypeScript |
收录时间：2026-06-09 · 更新时间：2026-06-11 · License：未公布 · AI Skill Hub 不对第三方内容的准确性作法律背书。