Installation
Prerequisites
- Python 3.11+ - CATS requires Python 3.11 or later
- AWS credentials - Access to an AWS account where you can deploy CloudFormation stacks
Install CATS
CATS is published as aws-cats on PyPI.
Add it to your project with uv (recommended). uv add needs a pyproject.toml; in a
new directory, uv init writes one first:
Or install with pip:
For the CLI alone, without a project (for example to run cats infra from a pipeline
image), uv tool install aws-cats puts cats on the PATH, and uvx --from aws-cats cats
runs it without installing.
The distribution name is
aws-cats; the import package (import cats) and thecatsCLI command are bothcats.
Optional extras
uv add 'aws-cats[mcp]' # the `cats mcp` MCP server for AI agents
uv add 'aws-cats[types]' # typed boto3 clients for IDE autocomplete and mypy
The core install covers every other command. [types] is ~119 MB of type
stubs; install it where you type-check tests or generated cats_types.py.
Verify Installation
You should see the installed version, for example 1.0.0.
Optional: YAML Schema Support
CATS provides a JSON schema for cats.yaml validation. To enable autocomplete and validation in your editor:
VS Code: Install the YAML extension, then add this line to the top of your cats.yaml:
Run cats validate to generate the schema file.
Next Steps
Continue to the Quickstart to run your first test.