aios-cli 0.1.0

Developer SDK and CLI for AIOS BIZ modules

AIOS BIZ SDK & CLI Tool

The AIOS BIZ Developer SDK and CLI is a Click-based tool that automates the creation, validation, packaging, and installation of modular AIOS BIZ modules.

Installation

Recommended — from PyPI

pip install aios-cli

Verify the installation:

aios --help

Alternative — from the platform's Developer Portal

Download the SDK ZIP from your AIOS BIZ instance's Developer Portal and install it in an isolated Python environment:

pip install -e /path/to/extracted/aios-sdk

Development (within the backend repo)

cd backend
uv pip install -e ../sdk
uv run aios --help

Quickstart

# 1. Scaffold a new module
aios init invoice --name "Invoice Manager" --vendor "MyCompany" --resource "invoice"

# 2. Validate the module structure
aios validate ./invoice

# 3. Build a deployable .aios package
aios build ./invoice

# 4. Install on your AIOS BIZ Core instance
aios install ./invoice.aios --url http://your-core-url --token <your_jwt_token>

CLI Commands

1. Initialize a Module

Scaffold a new module skeleton (interactively, or via flags):

aios init invoice --name "Invoice Manager" --vendor "MyCompany" --resource "invoice" --ui-mode "schema"

Options:

• -n, --name TEXT: Display name of the module.
• -v, --vendor TEXT: Vendor/Author namespace.
• -r, --resource TEXT: Lowercase singular initial resource name.
• -u, --ui-mode [schema|custom]: Frontend rendering mode.
• --sample-tool/--no-sample-tool: Include standard AI-callable tool stub.

2. Validate a Module

Run checks against the manifest.json schema and verify python code syntax rules:

aios validate ./invoice

3. Build a Package

Package the module source files into a .aios archive:

aios build ./invoice

This runs validation first automatically, refusing to build if validation fails.

4. Install a Package

Install the built package on a running Core backend:

aios install ./invoice.aios --url http://127.0.0.1:8000 --token <your_auth_jwt_token>

Resources

• SDK Download also available from your AIOS BIZ Core instance's Developer Portal