メニュー
Use when the user wants to install cuga, start the demo/web UI, or asks what `cuga start` does or which service/mode to run.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/cuga-project/cuga-harness-kit --skill cuga-install-and-launchコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
| name | cuga-install-and-launch |
| description | Use when the user wants to install cuga, start the demo/web UI, or asks what `cuga start` does or which service/mode to run. |
For a new app project, initialize with uv and add cuga as a dependency so it is recorded in pyproject.toml:
uv init my-cuga-app
cd my-cuga-app
uv add cuga
For an existing project that already has a pyproject.toml, run uv add cuga from the project root. If the user only wants a quick install inside an already-active virtualenv, uv pip install cuga is acceptable.
(cuga requires Python >= 3.10, < 3.14.) For working inside a checkout of the cuga-agent repo itself instead of the published package:
git clone https://github.com/cuga-project/cuga-agent.git
cd cuga-agent
uv venv --python=3.12 && source .venv/bin/activate
uv sync
Set LLM API keys before starting anything. Use a project-local .env; see docs/cuga-env-api-keys.md for provider-specific AGENT_SETTING_CONFIG, MODEL_NAME, and API-key examples.
uv run cuga start <service>
Valid <service> values: demo, demo_skills, demo_crm, demo_docs, demo_health, demo_knowledge, demo_supervisor, travel_agent, manager, registry, appworld.
demo / demo_crm / demo_supervisor / demo_knowledge / demo_docs — launch the chat web UI at https://localhost:7860 plus a tool registry service on port 8001, each preset wiring up different sample tools (CRM+email, multi-agent supervisor, RAG knowledge, docs) so you can try the matching capability immediately.demo_skills — same UI, with cuga's own runtime skill-loading enabled (see cuga-build-cuga-skill).manager — a draft/publish UI: edit agent config (tools, MCP servers, LLM, policies) as a draft, try it, then publish a versioned config for production chat.registry — just the tool registry service (OpenAPI/MCP config), no chat UI.appworld / travel_agent — specific benchmark/example scenarios.Other useful commands:
cuga stop <service> — stop a running service.cuga status — show what's currently running.cuga doctor — environment/dependency sanity check.cuga viz — trajectory viewer dashboard (see cuga-debug-trajectory).There is no cuga policy or cuga knowledge CLI subcommand — policies and knowledge are managed through the Python SDK (agent.policies.*, agent.knowledge.*, see cuga-author-policy / cuga-knowledge-rag) or through the manager web UI.
Once the UI is up, point the user at cuga-build-agent for writing their own Python code against the SDK, or have them just chat with the demo agent directly in the browser.
Use when the user wants to govern agent behavior with a cuga policy - block/redirect an intent, add step-by-step playbook guidance, require approval before a tool runs, enhance a tool's description, or reshape agent output format.
Use when the user wants to write Python code that creates or invokes a CugaAgent or CugaSupervisor, e.g. "build an agent with cuga", "how do I call agent.invoke", "set up a multi-agent supervisor".
Use when the user wants a running CugaAgent to load a new capability at runtime via cuga's own skill system, e.g. "add a skill to my agent", "create a .cuga/skills SKILL.md", "how does load_skill work".