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.2.tar.gz (58.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.2-py3-none-any.whl (60.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: a3ip-1.5.2.tar.gz
  • Upload date:
  • Size: 58.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.2.tar.gz
Algorithm Hash digest
SHA256 33358b72e994de5cca095042915766418c3ff91dc0de1f48355564c652478a8b
MD5 b7b72376ebe50d6e31fb959d7859953b
BLAKE2b-256 5db096fbd555e2b3831a63ce48e03b53eb7e273bd0248bf28191b9d7385f8c96

See more details on using hashes here.

File details

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

File metadata

  • Download URL: a3ip-1.5.2-py3-none-any.whl
  • Upload date:
  • Size: 60.1 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6727fe6b5f35f0ce67fb867c80c6ba77e99389443c198ca914662b320b647f93
MD5 71652c30771441dc7b366fc11ee1b084
BLAKE2b-256 110a494a04bc6c676990fef52f5c79c44596066ba223229c7b99d6948a6d3a7d

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