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 # opens City Hall /device; credentials → ~/.config/city/teams/t07/
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 |
Device flow: CLI prints a user code, City Hall /device approves for your roster team, then session + Team Controller Key land under ~/.config/city/teams/<team>/. Team must exist in Admin Teams. --api-url local self-approves for offline DX. |
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.12
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.12.tar.gz | 59.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| city_cli-0.9.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 141.1 kB
Release files / city_cli-0.9.12.tar.gz
| Download URL | city_cli-0.9.12.tar.gz |
|---|---|
| Size | 59.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
42355938e0eab0780e17a224d056adcd82be22f83722526a2bf6b0d455d77c11
|
|
BLAKE2b-256 checksum How to use checksums |
0d6a8732389fe9fc007164746b429d9fd0a93c714f8f360755bdcbb520a3f28b
|
| 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.12-py3-none-any.whl
| Download URL | city_cli-0.9.12-py3-none-any.whl |
|---|---|
| Size | 81.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5760d7acf5f7315c0a9d83ae4419722db4326489f888d303f3818a566feebe9d
|
|
BLAKE2b-256 checksum How to use checksums |
271fe5ff47b8e29ddea9d1a8c5ec25a5b4188eadaeff3c1e2c6035da30a837f8
|
| 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.12
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.
