项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 10180
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Python 环境(可执行 pip 命令)
- Windows 系统环境(UFO² 面向 Windows 桌面自动化)
- 可用的 OpenAI 或 Azure OpenAI API Key 与模型服务
- 能访问项目源码仓库及官方文档站点
安装与启动步骤
-
1获取项目源码
从项目 GitHub 仓库获取 UFO 源码并放到本地目录,后续所有命令都在该目录下执行。
-
2安装依赖
在项目根目录执行依赖安装,README 中 Galaxy 与 UFO² 两条路径均使用同一条命令。
pip install -r requirements.txt -
3配置 LLM
编辑配置文件填入模型服务信息:UFO² 改 config/ufo/agents.yaml,Galaxy 改 config/galaxy/agent.yaml。
-
4运行 UFO²
以任务名参数启动 UFO² 桌面代理,把 my_task 换成你自己的任务标识名,随后按提示描述任务。
python -m ufo --task my_task
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
API_TYPE | 是 | 模型服务类型,OpenAI 填 openai,Azure 填 aoai | openai |
API_BASE | 是 | 模型接口地址,OpenAI 用官方 URL,Azure 用资源地址 | https://api.openai.com/v1/chat/completions |
API_KEY | 是 | 模型服务密钥,替换成你自己的真实 Key | sk-your-key-here |
API_MODEL | 是 | 调用的模型名称 | gpt-4o |
API_DEPLOYMENT_ID | 否 | Azure OpenAI 专用,填部署 ID,用 OpenAI 时不需要 | your-deployment-id |
VISUAL_MODE | 否 | UFO² 配置文件中的视觉模式开关 | True |
如何确认成功
执行 python -m ufo --task my_task 后无鉴权或配置报错、代理开始解析并执行任务即视为启动成功。
常见问题
Q:Galaxy 和 UFO² 该改哪个配置文件?
A:Galaxy 请编辑 config/galaxy/agent.yaml,并在 CONSTELLATION_AGENT 下配置;UFO² 请编辑 config/ufo/agents.yaml。
Q:只能用 OpenAI 吗?
A:不止。README 指出还支持 Qwen、Gemini、Claude 等,具体参见官方 Model Configuration Guide。
Q:用 Azure OpenAI 要补哪些字段?
A:API_TYPE 改为 aoai,API_BASE 填资源地址,并额外提供 API_DEPLOYMENT_ID。
Q:安装依赖时报找不到 requirements.txt 怎么办?
A:说明当前不在项目根目录,请先进入源码根目录再执行 pip install -r requirements.txt。
注意事项
- 配置文件中要填入真实 API Key,不要提交到代码仓库
- README 节选未给出 Galaxy 的具体运行命令,跨设备编排需查阅 Galaxy 专属 README
- 各平台特有的详细安装步骤请参考官方文档 https://microsoft.github.io/UFO/
核心亮点
- 动态任务分解:自动将复杂问题拆解为子任务并分派给最合适的代理
- 灵活代理编排:支持自定义代理角色、工具和协作模式,适应多样场景
- 活跃社区与快速迭代:GitHub星标近万,持续更新,问题响应及时
不足之处
- 文档/社区待观察
- 依赖大模型API,运行成本较高
适用场景
- 企业自动化流程中多步骤任务处理
- 研究项目中多模型协同实验
- 智能客服系统中多领域知识整合
替代项目
AutoGen、MetaGPT、CrewAI
上一篇:open-swe
下一篇:astron-agent
同类项目推荐
Vrooli
开源
让一群AI智能体自动协作干活,还能越干越聪明
Open-source, self-improving autonomous agent swarm
n8n-claw
开源
用 n8n 可视化搭建自主 AI 代理,一个脚本搞定部署
OpenClaw-inspired autonomous AI agent built entirely in n8n. Adaptive RAG-powered me···
sandboxed.sh
开源
让链上 AI 代理安全自主运行,隔离沙箱+加密密钥,防乱操作
All your AI providers, machines, and agent harnesses in one place. Free & native
ha-claude
开源
给 Home Assistant 装上 AI 大脑,动嘴就能控制全屋智能。
Home Assistant add-on: Claude Code, OpenAI/GPT, Gemini
always-accompany
开源
一个上下文,陪你聊天也陪你干活
Companionship, chat, coding, and work share one memory and context framework — the ···
pr-review-agent-council
开源
让多个AI辩论式审查PR,生成结构化报告并自动评估。
学习 learn-claude-code 后的 PR Review Agent 实践项目:构建 Debate Council 多 Agent 审···
caspian-sdk
开源
一套 SDK,让 AI 智能体打通所有主流通信渠道
Agent communication SDK. The open-source agent communication layer for AI agents — ···
.claude
开源
零配置让 Claude Code 技能全开,自动匹配资源干活
The Ultimate Claude Code Toolkit: 180 skills, 10 agents, 29 commands, 7 hooks, and 8···
eko
开源
用大白话写工作流,自动生成可上线的 AI 智能体
Eko (Eko Keeps Operating) - Build Production-ready Agentic Workflow with Natural Lan···
