Coco
Get started

Install

Choose the Coco packages your project needs, install them from the package index, and upgrade.

Choose the Coco packages your project needs and install them from the package index.

The Quickstart installs what most projects need. This page covers the other options. The commands below use COCO_INDEX, which you set in Install the SDK.


Requirements

RequirementVersionUsed for
Python3.10 or laterThe SDK and your agent.
uvCurrentInstalling from the package index.
Coco API keycoco_live_... or coco_test_...The package index and the hosted services.
Node20 or laterThe TypeScript packages only.

Choose what to install

Install the set that matches your agent:

uv pip install --index "coco=$COCO_INDEX" coco-framework trustcoco-sdk   # agents on coco-framework
uv pip install --index "coco=$COCO_INDEX" "trustcoco-sdk[langchain]"     # agents on upstream LangChain and LangGraph
uv pip install --index "coco=$COCO_INDEX" trustcoco-sdk                  # the engine and the coco command only
coco --help                                                              # the command, whichever set you installed

Run one install line. In a new environment it prints Installed N packages and lists trustcoco-sdk with its version, and coco --help then prints the command's usage, starting usage: coco.

Package or extraWhat it adds
trustcoco-sdkThe engine, CocoGuard, RemoteEngine, the Claude Code hook, and the coco command. Needs only the standard library and PyYAML.
coco-frameworkThe agent runtime, from PyPI. It holds create_agent, the OpenAI and Anthropic chat models, and the SQLite checkpointer, and the agent coco init writes runs on it. See the framework's Install.
[langchain]Upstream langchain and langgraph, 1.0 or later.
[eval]pyarrow, for the payment benchmark in Evaluate.

Keep in mind: Don't add the [framework] extra to trustcoco-sdk when you install coco-framework. The extra installs the same runtime as separate trustcoco-* packages, which hold the same modules.

How the package index works

The SDK isn't on PyPI yet. The hosted gate serves it at /v1/sdk/simple/, behind your API key. coco-framework is on PyPI, and the index doesn't hold it, so uv takes it from PyPI.

  • Authentication: The key is the password. The user name can be anything.
  • Which keys work: Any unrevoked key, coco_live_ or coco_test_, bound to a project or not.
  • Failed sign-in: A missing or wrong key returns 401.

Keep in mind: Use uv, not pip. uv takes each package from the first index that holds it, so a trustcoco-* name someone else registers on PyPI never replaces Coco's. pip's --extra-index-url takes the highest version from either index, so a look-alike package could win.

TypeScript packages

@trustcoco/sdk and @trustcoco/cli aren't published to npm yet. For access, contact us at trustcoco.ai. To build the installer from a checkout, see Claude Code.

Upgrade

Upgrade the packages:

uv pip install --upgrade --index "coco=$COCO_INDEX" coco-framework trustcoco-sdk
uv pip show trustcoco-sdk

uv lists each package it upgraded, or ends Checked 35 packages when you already have the latest, and uv pip show prints the installed Version. To confirm the API still answers, repeat the health check and test transaction.


Need Help?

We want your install to go smoothly. If you get stuck, contact us at trustcoco.ai.

On this page