cuga-agent

Overview of cuga-agent

What it is

CUGA is an open-source generalist agent harness for the enterprise. It supports complex task execution on web and APIs, OpenAPI/MCP integrations, composable architecture, reasoning modes, and policy-aware features. The project is built with IBM SiL and is licensed under Apache 2.0.

Key features

• Sovereignty: Run the harness in your environment, connect privately hosted models and tools, and preload supporting model artifacts for disconnected deployments.
• Execution policies: Block disallowed intents, require approval for selected tools, guide workflows with playbooks, and configure tool-level guards. Includes five policy types: Intent Guard, Playbook, Tool Approval, Tool Guide, and Output Formatter.
• Inference efficiency: Choose open models, tune reasoning modes, shortlist relevant tools, set tool-call budgets, and inspect token usage with per-run receipts.
• Faster delivery: Connect MCP servers, OpenAPI services, and Python tools. Configure and test an agent in the UI before publishing a version.
• Recurring automation: Use the separate events service to run agents on schedules, webhooks, and application events, with run history in Events Studio.
• Reusable experience: Load task-specific skills from SKILL.md files and use a configured Evolve integration to retrieve relevant guidance and user preferences.

Use cases

• Revenue operations: Match a contact list against CRM, join account data, calculate revenue percentiles, and draft a report. Gate account updates with Tool Approval.
• Knowledge assistance: Search company documents, answer with citations, and combine shared reference material with documents uploaded to a conversation.
• Cross-application operations: Use CugaSupervisor to coordinate specialized agents, each with its own tools and instructions, and prepare results for review.
• Browser and API automation: Combine structured API calls with browser interactions for workflows spanning services and web interfaces.
• Recurring operations: Schedule a weekday report or react to a new document through the events service, then deliver the result to a configured channel.

Getting started

Use Python 3.12 and uv. bash git clone https://github.com/cuga-project/cuga-agent.git cd cuga-agent uv sync --python 3.12 test -f .env || cp .env.example .env Set your provider, model, and credentials in .env. Then start the manager with CRM tools: bash uv run cuga start manager --crm Open /manage at the local URL printed by the CLI.

License and pricing

Licensed under Apache 2.0. The project is open source and free to use.

Based on the project's public README and repository metadata.