{"data":{"slug":"cuga-project-cuga-agent","name":"cuga-agent","tagline":"CUGA is an open-source generalist agent for enterprise complex task execution on web and APIs","github_url":"https://github.com/cuga-project/cuga-agent","owner":"cuga-project","repo":"cuga-agent","owner_avatar_url":"https://avatars.githubusercontent.com/u/230847519?v=4","primary_language":"Python","stars":1043,"forks":182,"topics":["coding-agent","computer-use","enterprise","generalist-agent","guardrails","harness","knowledge","mcp","policies","sandbox"],"archived":false,"github_pushed_at":"2026-10-19T11:01:43+00:00","maintenance_label":"Very active","stars_delta_30d":166,"url":"https://www.graphcanon.com/tools/cuga-project-cuga-agent","markdown_url":"https://www.graphcanon.com/tools/cuga-project-cuga-agent.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/cuga-project-cuga-agent","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=cuga-project-cuga-agent","description":"CUGA is an open-source generalist agent harness for the enterprise, supporting complex task execution on web and APIs, OpenAPI/MCP integrations, composable architecture, reasoning modes, and policy-aware features.","homepage_url":"https://cuga.dev","license":"Other","open_issues":287,"watchers":5,"ai_summary":"Supports OpenAPI/MCP integrations, reasoning modes, policy-aware features.","readme_excerpt":"## Quick install\n\nUse **Python 3.12** and [uv](https://docs.astral.sh/uv/getting-started/installation/).\n\n```bash\ngit clone https://github.com/cuga-project/cuga-agent.git\ncd cuga-agent\nuv sync --python 3.12\ntest -f .env || cp .env.example .env\n```\n\n<a id=\"llm-configuration---advanced-options\"></a>\n\nSet your provider, model, and credentials in `.env`. See [model configuration](docs/readme/configuration-guide.md#supported-platforms) for supported providers.\n\n```bash\nuv run cuga start manager --crm\n```\n\nOpen `/manage` at the local URL printed by the CLI. Try the CRM tools, configure policies, and test a draft before publishing. [More source and demo options](#develop-from-source).","github_created_at":"2025-09-11T11:58:55+00:00","created_at":"2026-07-15T10:42:20.633154+00:00","updated_at":"2026-10-20T06:00:50.312636+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"}],"tags":[{"slug":"coding-agent","name":"coding-agent"},{"slug":"computer-use","name":"computer-use"},{"slug":"enterprise","name":"enterprise"},{"slug":"generalist-agent","name":"generalist-agent"},{"slug":"guardrails","name":"guardrails"},{"slug":"harness","name":"harness"},{"slug":"knowledge","name":"knowledge"},{"slug":"mcp","name":"mcp"}],"trust":{"provenance":{"is_fork":false,"github_id":1054838518,"owner_type":"Organization","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-10-20T06:00:48.694Z","maintenance":{"label":"Very active","score":96,"methodology":"github_public_v1","releases_90d":4,"days_since_push":0,"last_release_at":"2026-10-16T19:24:43Z","stars_delta_30d":166,"open_issues_delta_30d":108},"security_summary":{"last_scan_at":"2026-07-15T10:42:23.261954+00:00","scan_profile":"mcp_manifest","status":"findings","critical_count":0,"high_count":0,"medium_count":0,"low_count":2,"scanner":"mcp_manifest@v1","scan_id":"e04148d0-1ece-44fb-a895-146149bbe990","pending_review_count":0}},"capability_facts":{"mcp":{"method":"github-tree-and-contents@2","reason":"No explicit MCP server declaration was found in the inspected manifests. Other layouts and implementations were not tested.","source":"repo_scan","status":"unknown","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/tree/88fd35499813a15844bfb18eee2497ecdf217343","observed_at":"2026-10-20T06:00:49.110Z","server_manifest":null},"scan":{"method":"github-tree-and-contents@2","source":"repo_scan","status":"complete","version":2,"coverage":{"scope":"bounded-repository-manifests","tree_complete":true,"selected_files":9,"candidate_files":9},"revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/tree/88fd35499813a15844bfb18eee2497ecdf217343","observed_at":"2026-10-20T06:00:49.110Z","observations":[{"path":"@revision","bytes":4706,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/commit/88fd35499813a15844bfb18eee2497ecdf217343","http_status":200,"observed_at":"2026-10-20T06:00:49.280Z"},{"path":"@tree","bytes":630206,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/tree/88fd35499813a15844bfb18eee2497ecdf217343","http_status":200,"observed_at":"2026-10-20T06:00:49.575Z"},{"path":"deployment/docker-compose/openlit/docker-compose.yml","bytes":2217,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/deployment/docker-compose/openlit/docker-compose.yml","http_status":200,"observed_at":"2026-10-20T06:00:49.946Z"},{"path":"docker-compose.yml","reason":"not-listed-in-complete-tree","status":"not-found","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/tree/88fd35499813a15844bfb18eee2497ecdf217343","observed_at":"2026-10-20T06:00:49.580Z"},{"path":"Dockerfile","bytes":1556,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/Dockerfile","http_status":200,"observed_at":"2026-10-20T06:00:49.820Z"},{"path":"mcp.json","reason":"not-listed-in-complete-tree","status":"not-found","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/tree/88fd35499813a15844bfb18eee2497ecdf217343","observed_at":"2026-10-20T06:00:49.580Z"},{"path":"package.json","reason":"not-listed-in-complete-tree","status":"not-found","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/tree/88fd35499813a15844bfb18eee2497ecdf217343","observed_at":"2026-10-20T06:00:49.580Z"},{"path":"pyproject.toml","bytes":20227,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/pyproject.toml","http_status":200,"observed_at":"2026-10-20T06:00:49.836Z"},{"path":"server.json","reason":"not-listed-in-complete-tree","status":"not-found","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/tree/88fd35499813a15844bfb18eee2497ecdf217343","observed_at":"2026-10-20T06:00:49.580Z"},{"path":"src/frontend_workspaces/agentic_chat/package.json","bytes":3571,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/src/frontend_workspaces/agentic_chat/package.json","http_status":200,"observed_at":"2026-10-20T06:00:49.696Z"},{"path":"src/frontend_workspaces/extension/package.json","bytes":2588,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/src/frontend_workspaces/extension/package.json","http_status":200,"observed_at":"2026-10-20T06:00:49.699Z"},{"path":"src/frontend_workspaces/frontend/package.json","bytes":3020,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/src/frontend_workspaces/frontend/package.json","http_status":200,"observed_at":"2026-10-20T06:00:49.717Z"},{"path":"src/frontend_workspaces/package.json","bytes":2812,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/src/frontend_workspaces/package.json","http_status":200,"observed_at":"2026-10-20T06:00:49.700Z"},{"path":"src/frontend_workspaces/runtime/package.json","bytes":520,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/src/frontend_workspaces/runtime/package.json","http_status":200,"observed_at":"2026-10-20T06:00:49.839Z"},{"path":"src/frontend_workspaces/shared/package.json","bytes":642,"status":"present","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/src/frontend_workspaces/shared/package.json","http_status":200,"observed_at":"2026-10-20T06:00:49.826Z"}]},"has_cli":{"value":true,"method":"repository-declaration@2","source":"pyproject.toml:[project.scripts]","status":"declared","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/pyproject.toml","observed_at":"2026-10-20T06:00:49.110Z"},"languages":{"value":["python","javascript","typescript"],"method":"github-tree-and-contents@2","source":"github.language+src/frontend_workspaces/agentic_chat/package.json+src/frontend_workspaces/extension/package.json+src/frontend_workspaces/package.json+src/frontend_workspaces/frontend/package.json+src/frontend_workspaces/shared/package.json+pyproject.toml+src/frontend_workspaces/runtime/package.json","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/tree/88fd35499813a15844bfb18eee2497ecdf217343","observed_at":"2026-10-20T06:00:49.110Z"},"has_docker":{"value":true,"method":"repository-declaration@2","source":"dockerfile:Dockerfile","revision":"88fd35499813a15844bfb18eee2497ecdf217343","source_url":"https://github.com/cuga-project/cuga-agent/blob/88fd35499813a15844bfb18eee2497ecdf217343/Dockerfile","observed_at":"2026-10-20T06:00:49.110Z"},"license_spdx":{"value":"Apache-2.0","source":"github.license","observed_at":"2026-10-20T06:00:49.110Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["You need precise control over agent configuration including tools, API integrations, LLM selection, and policies.","Your organization requires self-hosting capabilities on Kubernetes for enhanced security and customization."],"when_not_to_use":["If your enterprise cannot support Python 3.12+ and the uv package manager prerequisites.","In scenarios where a non-customizable, cloud-managed agent service is preferred over a self-hosted solution."],"source":"enrich:decision_facts","observed_at":"2026-07-17T06:03:35.723Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"Unverified catalog guidance: CUGA is an open-source agent for managing complex enterprise tasks on the web and APIs with strong emphasis on composable architecture and policy-aware features."}]}}