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.3.tar.gz (53.1 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.3-py3-none-any.whl (56.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: a3ip-1.5.3.tar.gz
  • Upload date:
  • Size: 53.1 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.3.tar.gz
Algorithm Hash digest
SHA256 277c961adf4fbd830c83adc1df1bbb5c8e410980e56f952d901a4af40e5a196c
MD5 61eb7fec1191f7049ab5a41eff6519d5
BLAKE2b-256 b21c6cb04ccee4f81796985d614ee1aece1b78e08afd0e81cbd11ceeb864e445

See more details on using hashes here.

File details

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

File metadata

  • Download URL: a3ip-1.5.3-py3-none-any.whl
  • Upload date:
  • Size: 56.2 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 34cd597f2d35bba4d8b79ed338796de735db69040abd072418feab355c9d6ad7
MD5 4eeda752974e45ffca4d7d9c757f237e
BLAKE2b-256 d32b9a22a5a32d91bf6e4f07dca355800ae54e7e6dce90ca6bbc6b92706e6359

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