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 # listen; finish in City Hall /device → ~/.config/city/teams/<roster>/
city init agent demo # creates ./demo/ with the template (no secrets inside)
cd demo
# edit card.yaml role if needed (cup|facility|mmg|b2b)
city card validate
city deploy --promote
city status agent:t07/demo
Team session + controller key live under $XDG_CONFIG_HOME/city/teams/<team>/ (or $CITY_HOME/teams/<team>/). Set CITY_CREDENTIALS=project only when you need a project-local .city/ override (CI).
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
cd demo
city --api-url local dev
city --api-url local conform --profile fast
Commands (overview)
| Command | Purpose |
|---|---|
city login |
Like gcloud auth login: CLI listens, you finish in City Hall /device; roster team comes from the browser. Optional --team only asserts a private expectation (mismatch never names the other team). --api-url local requires --team and self-approves. |
city keys init |
Escape hatch: regenerate controller key + register public key |
city init agent <name> |
Create <name>/ from a starter template (--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 |
Links
- Source: projectnandaitaly/agentic-city
- SDK: city-sdk on PyPI
- Spec: City Deploy CLI §10.2 in the repo docs
License
Proprietary — Project NANDA Italy / Milano Agentic City event kit.
1 maintainer
Metadata
1 maintainer
Release files for city-cli 0.9.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| city_cli-0.9.13.tar.gz | 59.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| city_cli-0.9.13-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 141.5 kB
Release files / city_cli-0.9.13.tar.gz
| Download URL | city_cli-0.9.13.tar.gz |
|---|---|
| Size | 59.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3b290a68f31e50dda87fd2869e880af9ad49cbedb1166236542df520d1d864fd
|
|
BLAKE2b-256 checksum How to use checksums |
403951295dbe89118ea451032c102ff5c068936fc9125bf8e7522a239e4b3e63
|
| 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.13-py3-none-any.whl
| Download URL | city_cli-0.9.13-py3-none-any.whl |
|---|---|
| Size | 82.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
528efdd24b36a276ac83235f45c551d15ab4691cde6968ca62549910663f5f2f
|
|
BLAKE2b-256 checksum How to use checksums |
2862cb4cc8e4aad78e663a455b0177ad7cfd6cd8ad28038a20321ec02fcf385a
|
| 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.13
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.
