ainl

name	AINL
description	Deterministic compiled graphs for ZeroClaw (importer, runtime, MCP tools)
install	./install.sh
install_alt	pip install 'ainativelang[mcp]' && ainl install-mcp --host zeroclaw
commands	["ainl import <source> — convert Markdown / ecosystem packs into `.ainl` graphs","ainl compile <file.ainl> — compile and validate deterministic graph IR","ainl run <file.ainl> — run compiled workflow (when your graph uses the runtime path)","zeroclaw ainl run <file.ainl> — same via ZeroClaw shim after install (see install-mcp --host zeroclaw)"]
tags	["ainl","graphs","mcp","zeroclaw"]

AINL for ZeroClaw

AINL is an AI-native language that compiles deterministic graphs. In ZeroClaw, use it to import workflows, compile them, run them, and expose ainl-mcp tools to the agent.

Package: ainativelang v1.8.0 (this tree; PyPI after publish — docs/RELEASING.md). Optional extras: [mcp], [solana].

Agent instructions

Follow this skill when the user is on ZeroClaw (or wants deterministic .ainl graphs with import / compile / run / MCP). Prefer ./install.sh after zeroclaw skills install …, or the manual pip install 'ainativelang[mcp]' && ainl install-mcp --host zeroclaw path (alias ainl install-zeroclaw). After bootstrap, suggest the morning briefing prompt example below when it fits.

When to use this skill

• The user wants portable, compiled workflows (.ainl) instead of ad-hoc prompts.
• They mention import, compile, morning briefing, clawflows, ecosystem, or deterministic graphs.
• They need MCP access to validation / compile / ecosystem listing (ainl-mcp).

Install (pick one)

1. From this skill directory (recommended with zeroclaw skills install): run ./install.sh
   That upgrades ainl[mcp] and runs ainl install-mcp --host zeroclaw (pip self-upgrade, MCP registration hints, ~/.zeroclaw/bin/ainl-run shim).

2. Manual:
   pip install 'ainativelang[mcp]' && ainl install-mcp --host zeroclaw

Restricted environments (OpenClaw, Clawbot, webchat sandboxes)

This skill is designed for environments with PEP 668 externally-managed Python (Python 3.13+, sudo blocked).

• Preferred no-root order is: python -m venv first, then --user, then --break-system-packages as a last resort.
• The installer automatically uses compatible fallback modes when default pip fails.
• Clean uninstall (if needed):

pip3 uninstall -y ainl mcp aiohttp langgraph temporalio
rm -rf /tmp/ainl-repo /data/.openclaw/workspace/skills/ainl /data/.local/lib/python3.13/site-packages/*ainl*

Commands the user cares about

Command	Purpose
ainl import …	Import Markdown or ecosystem sources into .ainl
ainl compile …	Compile / validate graphs
ainl run …	Execute a graph via the CLI runtime where applicable
zeroclaw ainl run <file.ainl>	After bootstrap: wrapper that compiles/runs through the installed shim

After install — prompt suggestion

Tell the user they can say in ZeroClaw:

Import the morning briefing using AINL.

(They should point the importer at their Markdown or pack; ainl import subcommands match their source type.)

MCP

Configure the host to run ainl-mcp as a stdio MCP server (see AINL docs: External orchestration / MCP). ainl install-mcp --host zeroclaw aligns local setup with ZeroClaw paths where applicable. Authoring tools include ainl_get_started (pass wizard_state_json to continue), ainl_step_examples (snippets by topic), validate/compile responses with contract_validation_status, and resources ainl://strict-valid-examples and ainl://strict-valid-families. See repo AGENTS.md and docs/operations/MCP_AINL_WIZARD_AND_CORPUS.md.

References

• Upstream: github.com/sbhooley/ainativelang
• Package: ainativelang on PyPI