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.4.tar.gz (53.4 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.4-py3-none-any.whl (56.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: a3ip-1.5.4.tar.gz
  • Upload date:
  • Size: 53.4 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.4.tar.gz
Algorithm Hash digest
SHA256 fb3aeba9d9d1f09d57f3fcb065c929c413fef11080dae252ef212a1dcbbfdfdf
MD5 8f8c3803db46111348e640c4a91ec472
BLAKE2b-256 6e80ff072ecf7b271035830e8b5f29e213b18bea4d737b4f9be5c7e0c080ac6e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: a3ip-1.5.4-py3-none-any.whl
  • Upload date:
  • Size: 56.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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 18bca3e41112b215282ed34e3440c534cce5713f67cd5439b72668c017cd76f8
MD5 81dea3f189ebdd53d4c3a01545b7928c
BLAKE2b-256 8fb999f57f5b50ab292ef428f83ebe91b61ab6f0188509e76806849c86fb5f9d

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