Skip to main content

CLI for A3IP - AI Infrastructure Installation Package (pronounced 'ay-trip')

Project description

a3ip CLI

Pronounced "ay-trip"

PyPI Spec License

Command-line tool for creating, validating, and bundling A3IP packages.


Install

pip install a3ip

Optional: install with YAML support for faster, more reliable manifest parsing:

pip install "a3ip[yaml]"

Commands

a3ip new <name>

Scaffold a new package that passes a3ip validate on the first run.

a3ip new my-workflow

Creates my-workflow/ with:

my-workflow/
├── manifest.yaml          ← package metadata, permissions, components
├── CONFIGURE.md           ← questions to ask the user at install time
├── INSTALL.md             ← step-by-step install guide for the AI
├── README.md              ← human-facing description
├── components/
│   └── skills/
│       └── my-workflow.md ← the main skill file
└── scripts/               ← Python/PowerShell automation scripts go here

a3ip validate <package_dir>

Run 9 normative checks against the A3IP spec.

a3ip validate my-workflow/
Validating: my-workflow/

Check 1 (config coverage):     0 error(s)  0 warning(s)
Check 2 (script existence):    0 error(s)  0 warning(s)
...
Check 9 (trust→plan section):  0 error(s)  0 warning(s)

✓ Validation passed — no errors or warnings.

Exit code 0 if clean, 1 if any errors. Warnings don't affect the exit code.

Add --json to get a machine-readable report alongside the human output.


a3ip bundle <package_dir>

Build a .a3ip.bundle file ready to distribute.

a3ip bundle my-workflow/
# → my-workflow.a3ip.bundle

The bundle is a plain-text file containing every package file. Drop it into a conversation with any A3IP-compatible AI and ask it to install.

To include the spec for recipients who may not know A3IP:

a3ip bundle my-workflow/ --spec path/to/A3IP-SPEC-v1.5.md

Full example

pip install "a3ip[yaml]"

a3ip new code-review-flow
cd code-review-flow
# ... edit manifest.yaml, INSTALL.md, skills/ ...
a3ip validate .
a3ip bundle .
# → ../code-review-flow.a3ip.bundle

Links


License

Apache 2.0 — use freely in commercial and open source projects. Includes explicit patent grant.

A3IP CLI v1.0.0 · © 2026 Maksym Prydorozhko

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

a3ip-1.5.1.tar.gz (53.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

a3ip-1.5.1-py3-none-any.whl (55.5 kB view details)

Uploaded Python 3

File details

Details for the file a3ip-1.5.1.tar.gz.

File metadata

  • Download URL: a3ip-1.5.1.tar.gz
  • Upload date:
  • Size: 53.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for a3ip-1.5.1.tar.gz
Algorithm Hash digest
SHA256 9926543912e6ed1a1cfc8758dc97b68a493877ab69277249e352587fbf03ae61
MD5 1bf431b8eed6f6d7093753762ab52d70
BLAKE2b-256 86d289f3262e4face7d54d697c7b7f71093cd30815cc677ce15facc0dad0f09e

See more details on using hashes here.

File details

Details for the file a3ip-1.5.1-py3-none-any.whl.

File metadata

  • Download URL: a3ip-1.5.1-py3-none-any.whl
  • Upload date:
  • Size: 55.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for a3ip-1.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 782190fb0e465435bef9599bde0ee38a9a1e0581d06ad0496a459a44fb3e4a0e
MD5 48195c96bf760eabe825d6663578c010
BLAKE2b-256 9e4fa0a8bf16a7c8ab4be2aa9c0191e44688d6edd2ae3fb051c283a434787d2a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page