cuga-project/cuga-agent

The enterprise agent harness for sovereign, policy-controlled automation.
CUGA turns business requests into actions across your applications, APIs, and documents. Deploy in your private cloud or prepare an air-gapped environment, enforce fine-grained execution policies, and use open models on infrastructure you control. Connect your tools, configure your workflows, and optimize inference for your workload.
Get started · Documentation · Python SDK · Deploy on Kubernetes
CUGA Apps · CUGA Harness Kit · Discord
Apache 2.0 · Configurable Generalist Agent · Built with IBM SiL
English · 简体中文
## Quick install
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. See model configuration for supported providers.
bash
uv run cuga start manager --crm
Open /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.
Prefer to try it in your browser first? Open the quickstart notebook in Colab.
## Automate enterprise work. Keep control.
| Your priority | What CUGA gives you |
| Sovereignty | Run the harness in your environment. Connect privately hosted models and tools. 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. |
| 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 and use a configured Evolve integration to retrieve relevant guidance and user preferences. |
## See what you can build
Configure tools and policies beside a draft chat, then publish a version for users.
Current UI, captured from this repository with illustrative Revenue Operations configuration data. Internal endpoints and version labels are examples.
| Set approval policies | Manage specialized agents |
| Choose which tools need approval and show the proposed code before execution. | Configure individual agents and supervisors for different business workflows. |
### Watch the product tour
https://github.com/user-attachments/assets/2c51ab34-cb7a-43f8-aa1d-9a4cf8e27b5c
Visual tour of the current UI with sample configuration, flows, run history, and memory records. It does not show a live agent run. Media details.
## From a business request to a completed workflow
| Workflow | What an agent can do with the right tools and policies |
| Revenue operations | Match a contact list against CRM, join account data, calculate revenue percentiles, and draft a report. Gate account updates with Tool Approval. |