← Back to directory
A

AI Native Lang (AINL)

Community
Turn AI conversations into verifiable, repeatable structured workflows.
GitHub source repository ↗
★ 767 Stars Category · Dev Tools Very popular
64FMRS · C
Reliability
10/20
Security and permissions
11/20
Maintenance
15/20
Documentation
15/20
Setup experience
13/20

This is an Apache-2.0 open-source AINL repository maintained by sbhooley. It provides a compiler, deterministic runtime, graph IR, CLI, HTTP runner, and MCP server. The README documents MCP tools, stdio usage, and optional adapters; exact permissions depend on the workflow and runtime configuration.

Read the FMRS scoring method →

AINL is a compact, graph-canonical AI-native workflow language and runtime. It compiles workflows into a deterministic intermediate-representation graph and supports multi-step execution, state and memory, tool use, validation, control, visualization, an HTTP runner, and MCP integration.

Tools

ainl_validate
Validates an AINL workflow and returns structured diagnostics.
ainl_compile
Compiles an AINL workflow into a deterministic graph intermediate representation.
ainl_capabilities
Reports available capabilities.
ainl_security_report
Reports security configuration and capability information.
ainl_run
Executes an AINL workflow.
ainl_step_examples
Provides AINL step examples.
ainl_get_started
Provides onboarding guidance and wizard state.
ainl_ir_diff
Compares two AINL intermediate representations.
ainl_fitness_report
Generates a workflow fitness report from multiple runs.
ainl_list_ecosystem
Lists ecosystem workflow and agent resources.
ainl_import_clawflow
Imports Clawflows-style workflows.
ainl_import_agency_agent
Imports Agency-Agents-style agents.
ainl_import_markdown
Imports Markdown as an AINL workflow.

Setup

Requires Python 3.10 or newer. Install the MCP extra with pipx install 'ainativelang[mcp]' && ainl setup --auto, or use python3 -m pip install --user 'ainativelang[mcp]' && ainl setup --auto. Start ainl-mcp and configure it as a stdio server in the MCP client. Run ainl doctor to check integration.

Fit and risk

Best for

  • Teams building multi-step AI workflows with state, memory, and tool use
  • Teams seeking to reduce repeated prompt-loop orchestration
  • Projects requiring strict compile-time validation or execution auditing
  • Users of Claude Code, Codex, or other MCP-compatible agents

Not for

  • Users who only need simple hand-written scripts
  • Teams that already have deterministic runners and use LLMs only at judgment gates
  • Projects with no need for workflow validation, auditing, or MCP integration

Required permissions

  • Install and run a local Python program
  • Access workspace files, cache, or SQLite when corresponding adapters are enabled
  • Access networks or external services when HTTP, A2A, or other adapters are enabled
  • Use relevant environment configuration when workflows require secrets or external services

Risks and side effects

  • Enabling HTTP or A2A adapters introduces external network access risk
  • Workflows may access files, caches, databases, or secrets depending on adapters and policy configuration
  • Misconfigured adapter, step, runtime, or workspace limits may broaden execution scope
  • Machine-payment profiles are opt-in but may process HTTP 402 payment flows when enabled

Troubleshooting

  1. Confirm Python 3.10 or newer
  2. Confirm that ainativelang[mcp] is installed rather than only the base package
  3. Run ainl doctor to check host integration
  4. Check the MCP exposure profile, adapter allowlist, and execution limits
  5. If auto-cache is enabled, confirm that cache.json contains valid JSON
  6. For the dashboard, confirm that tests/emits/server/server.py has been generated

Use cases

Authoring and validating deterministic AI workflows
Compiling workflows into graph IR for repeated execution
Providing workflow validation, compilation, and execution to coding agents through MCP
Importing Clawflows- or Agency-Agents-style content
Building workflows with HTTP, filesystem, cache, SQLite, LLM, and memory adapters

Supported clients

Claude CodeFull support
CodexFull support
Gemini CLIFull support
Claude DesktopPartial support