cuga-agent

让企业安全跑通复杂网页与API自动化任务

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 208 🐛 待处理 263 👀 关注 5

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1140

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队cuga-project

官网地址https://cuga.dev

GitHubhttps://github.com/cuga-project/cuga-agent

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agentic-ai,agents,ai-agents,coding-agent,computer-use,enterprise,generalist-agent,guardrails,hacktoberfest,harness,knowledge,langgraph,llm,mcp,multi-agent,openapi,policies,python,rag,sandbox

GitHub 星标★ 1140

上线时间2025-09-11 00:00:00

代码更新2026-11-08

仓库体积167.8 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-10

浏览次数9

项目介绍

CUGA 是一个面向企业的开源通用智能体框架，旨在解决复杂任务在网页和 API 上的自动化执行问题。它支持 OpenAPI 和 MCP 集成，能够连接外部工具和服务；采用可组合的架构，允许开发者灵活搭建智能体流程；提供多种推理模式，适应不同任务需求；内置策略感知功能，可实施安全护栏和沙箱隔离，确保企业级应用的安全合规。CUGA 的核心能力包括任务规划、工具调用、知识整合和策略执行，帮助企业将 AI 智能体安全地部署到生产环境。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 1140

技术标签

agentic-ai agents ai-agents coding-agent computer-use

使用教程

难度：进阶约 15 分钟部署方式：本地安装 7 步

环境要求

Python 3.12
uv 包管理工具（需提前安装）
git（用于克隆仓库）
可访问的大模型服务凭据（provider / model / credentials）

安装与启动步骤

1克隆仓库

把 cuga-agent 源码拉取到本地，网络受限时可用代理或镜像源。
```
git clone https://github.com/cuga-project/cuga-agent.git
```
2进入项目目录

后续所有命令都在仓库根目录执行。
```
cd cuga-agent
```
3安装依赖

用 uv 按 Python 3.12 创建虚拟环境并同步依赖，首次执行耗时较长。
```
uv sync --python 3.12
```
4生成配置文件

若不存在 .env 则从 .env.example 复制一份，已存在时不会覆盖。
```
test -f .env || cp .env.example .env
```
5填写模型凭据

在 .env 里设置使用的 provider、model 与凭据，支持的服务商见配置指南文档。
6启动管理器

启动 CUGA manager 并加载 CRM 示例工具，启动后不要关闭该终端。
```
uv run cuga start manager --crm
```
7进入管理界面

在浏览器打开 CLI 打印出的本地 URL 加 /manage，试用 CRM 工具、配置策略并发布草稿。

关键配置

配置项	必填	说明	示例
`.env 中的 provider`	是	指定使用的大模型服务商，取值参考 .env.example	`参见 .env.example`
`.env 中的 model`	是	指定推理使用的模型名称	`参见 .env.example`
`.env 中的 credentials`	是	调用模型所需的 API 密钥等认证信息	`参见 .env.example`