Skip to main content

city-cli

Ship agents into Milano Agentic City — harness on, GCP off your laptop.

Install once, then scaffold an agent, run it locally, and publish it through the City Deploy API (ADR-010). Human output is colored for a terminal; --json stays machine-plain.

Requirements

  • Python 3.12+
  • For live deploy: Deploy API URL (see below)

Install

pipx install city-cli
# or
uv tool install city-cli
# or
pip install city-cli

This provides the city command. It depends on city-sdk for the Market facade and harness types.

Live city (remote Deploy API)

CITY_PLATFORM_URL defaults to https://deploy.projectnandaitaly.ai. CITY_DEPLOY_URL is an alias. No export is required for the live city.

city login --team t07
city init agent demo
# edit card.yaml role if needed (cup|facility|mmg|b2b)
city card validate
city deploy --promote
city status agent:t07/demo

Per-command override:

city --api-url https://deploy.projectnandaitaly.ai status agent:t07/demo

JSON for scripting:

city --json status agent:t07/demo

Local kit (in-process Deploy)

Use --api-url local (or CITY_PLATFORM_URL=local / CITY_DEPLOY_URL=local) for an in-process Deploy service (init, dev, offline checks).

city --api-url local init agent demo
city --api-url local dev
city --api-url local conform --profile fast

Commands (overview)

Command Purpose
city login Device-flow team session; stores token and ensures Team Controller Key under .city/
city keys init Escape hatch: regenerate controller key + register public key
city init agent <name> Scaffold project (--template cup|facility|mmg|b2b); agent type is card.yaml role
city card validate Validate card.yaml against the MHM card schema (base roles only)
city dev One local need through the harness
city conform Conformance suite (--profile full|fast, or --url)
city deploy Upload + pipeline; rejects non-base role before build (--promote, --runtime)
city promote / rollback / status / retire Lifecycle
city secrets set / city scale / city llm key rotate Ops
city compliance / city verify Receipts and offline verify

License

Proprietary — Project NANDA Italy / Milano Agentic City event kit.

Metadata

Release files for city-cli 0.9.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for city-cli 0.9.8
File Size Uploaded Provenance
city_cli-0.9.8.tar.gz 54.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for city-cli 0.9.8
File Interpreter ABI Platform
city_cli-0.9.8-py3-none-any.whl Python 3 none any Details

Total release size: 130.6 kB

Release files / city_cli-0.9.8.tar.gz

Download URL city_cli-0.9.8.tar.gz
Size 54.5 kB
Tags Source
SHA-256 checksum
How to use checksums
4c9fa8740e77b82c819fb2a29d512c951348d31672b14e6f641f84bcc304db6a
BLAKE2b-256 checksum
How to use checksums
dc66b38cc6d17e5c3e6cb4c9fcb8334ba84552526f7ef1802844b6490a7b06bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / city_cli-0.9.8-py3-none-any.whl

Download URL city_cli-0.9.8-py3-none-any.whl
Size 76.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
66a9c2c9e0d12e342bfee7df384d7a1eec6c2993c74af57d61601d6ae5b3c5c2
BLAKE2b-256 checksum
How to use checksums
eb2e838f5208b9222493fa7f037c47511cc54b0eb29d4293b3411da5c5f2bbe2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for city-cli 0.9.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page