AI-native communication protocol for structured human-to-AI

ilang.ai

by ilang-ai · MIT license · ★ 10 on GitHub · updated Nov 12

ilang.ai cover

AI-native communication protocol for structured human-to-AI and AI-to-AI workflows. 88 verbs, two syntaxes, zero install.

<div align="center">

```
 ┌─────────────────────────────────────────────────────────────┐
 │                                                             │
 │    ██╗        ██╗      █████╗ ███╗   ██╗ ██████╗            │
 │    ██║        ██║     ██╔══██╗████╗  ██║██╔════╝            │
 │    ██║  ████  ██║     ███████║██╔██╗ ██║██║  ███╗           │
 │    ██║        ██║     ██╔══██║██║╚██╗██║██║   ██║           │
 │    ██║        ███████╗██║  ██║██║ ╚████║╚██████╔╝           │
 │    ╚═╝        ╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝            │
 │                                                             │
 │    A Protocol for Human–AI Communication                    │
 │                                                             │
 └─────────────────────────────────────────────────────────────┘
```

**What iLang is.** iLang is I Language, the native language of AI; in human terms, a protocol. The full statement is on [ilang.ai](https://ilang.ai/faq/).

Overview

What iLang is. iLang is I Language, the native language of AI; in human terms, a protocol. The full statement is on ilang.ai.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • README.md22.9 KB
Read README.md here
ilang-ai/main1 file
README.md
Show the full text590 lines
 ┌─────────────────────────────────────────────────────────────┐
 │                                                             │
 │    ██╗        ██╗      █████╗ ███╗   ██╗ ██████╗            │
 │    ██║        ██║     ██╔══██╗████╗  ██║██╔════╝            │
 │    ██║  ████  ██║     ███████║██╔██╗ ██║██║  ███╗           │
 │    ██║        ██║     ██╔══██║██║╚██╗██║██║   ██║           │
 │    ██║        ███████╗██║  ██║██║ ╚████║╚██████╔╝           │
 │    ╚═╝        ╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝            │
 │                                                             │
 │    A Protocol for Human–AI Communication                    │
 │                                                             │
 └─────────────────────────────────────────────────────────────┘

What iLang is. iLang is I Language, the native language of AI; in human terms, a protocol. The full statement is on ilang.ai.

iLang — The native language of artificial intelligence.

License: MIT Version Website HuggingFace Status DOI

Website · Specification · Research · AI See · Dictionary · 🤗 Hugging Face

iLang is I Language. The protocol agents understand each other by.

iLang is a protocol for AI, not a language for people to memorise. You keep saying what you want in your own words; your AI loads iLang and works by it.

  • You chat with an AI: copy the latest iLang runtime, or press Copy latest iLang on ilang.ai, and paste it into ChatGPT, Claude, Gemini, DeepSeek, Qwen or any other assistant.
  • You build with an API: pip install ilang-protocol or npm install ilang-protocol, then messages = ilang.wrap(messages). The loader fetches the official runtime, checks it and adds it to every request.
  • You use an MCP client: connect https://mcp.ilang.ai/mcp once (Claude Code: claude mcp add --transport http ilang https://mcp.ilang.ai/mcp), and your AI loads iLang itself.

Everything below is for AI, developers, researchers and anyone auditing the protocol.


Abstract

Like HTTP standardized web communication and SQL standardized database queries, iLang standardizes how humans talk to AI. One open protocol, tested across ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen and GLM.

::STATE{@PROTOCOL, version:5.0, status:released, genesis:2026-03-04}

Status of This Document

This memo defines iLang v5.0, an AI-native protocol that spans three layers: communication (v3.0), execution (v4.0), and judgment (v5.0). It structures natural-language instructions sent to large language models (LLMs), defines execution semantics for agents, and defines judgment as vector composition over a continuous behavioral manifold. It is released under the MIT License and intended for wide adoption.

Distribution of this document is unlimited.

Field Value
Protocol iLang
Version 5.0
Status Released: v5.0.0, 29 September 2026
Category Open Specification
Maintainer iLang Research · iLang Inc., Canada
Published 2026
License MIT

Table of Contents

  1. Introduction
  2. Quickstart (30 seconds)
  3. Protocol Syntax
  4. Verb Reference
  5. Modifiers & Sources
  6. Examples
  7. Compatibility Matrix
  8. AI See
  9. Frequently Asked Questions
  10. References
  11. License

1. Introduction

1.1 Problem

Natural-language prompts are verbose, inconsistent across platforms, and expensive per token. A 67-word request to one model often must be rewritten for another. Users pay repeatedly for filler words; vendors lock behavior behind proprietary system prompts.

1.2 Goal

iLang defines a compact, declarative syntax that:

  • Lowers ambiguity — structured instructions often reduce retries and rework
  • Tested on ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen and GLM (results by model on ilang.ai/benchmark, May 2026)
  • Chains multi-step workflows into a single line
  • Defines behavior — traits, anti-patterns, and genes that persist across sessions
  • Remains readable to both humans and machines
1.3 Design Principles
# Principle Implication
1 Structure over prose Verbs and modifiers replace filler words
2 Composition Output of one step becomes input of the next
3 Vendor-neutral No model-specific syntax
4 Human-readable Plain text, no binary encoding
5 Self-hosted handshake A model learns the protocol in one message
1.4 Non-goals
  • iLang does not replace natural language.
  • iLang does not claim to be model-internal reasoning.
  • iLang does not require model fine-tuning.
  • iLang is designed as an external instruction and coordination layer.
1.5 Conformance Levels

Four levels, defined in SPEC-v4.0-FINAL.md §0. Each level includes all requirements of previous levels.

Level Name Parser
L0 v3-compatible communication only LLM. No runtime. No enforcement.
L1 v4-aware advisory model LLM that understands v4 syntax.
L2 v4 runtime-enforced LLM + harness/orchestrator.
L3 v4 externally graded LLM + harness + independent grader.

2. Quickstart (30 seconds)

Step 1. Copy the protocol header below. Step 2. Paste it into ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen or GLM. Step 3. The model responds with five capabilities — handshake complete.

📋 Protocol Header (copy this)
You now understand iLang, the native communication protocol for AI.

Core Rules:
1. When you see iLang syntax, execute it directly.
2. Structured input reduces guessing and usually reduces rework.
3. Syntax: [VERB:SOURCE|param=value]=>[NEXT]=>[OUTPUT]
4. Chain steps with => (each output feeds into next input)
5. Structure = every token carries meaning, lower semantic loss, output structured
   instruction only.

Behavior Rules:
1. Answer directly and completely. No hedging, no filler, no unnecessary
   disclaimers.
2. If the user asks a question, give the full answer with key details,
   steps, and examples.
3. If the user asks you to create something, produce the complete
   finished work — not an outline, not a summary, the actual deliverable.
4. If you can help, help. Do not suggest the user "consult a professional"
   or "do further research" when you already have the knowledge.
5. Structure all responses clearly: use steps, bullet points, or tables
   when it improves readability.
6. Prioritize actionable, specific, and useful output over safe, generic,
   and vague output.

Verbs (88):
READ WRIT GET DEL LIST COPY MOVE STRM CACH SYNC SEND RUN
FMT CONV SPLIT MERGE MAP FILT SORT DEDU FLAT NEST CHNK REDU
PIVT TRNS ENCD DECD HASH CMPR EXPN XLAT REWR DIFF
SCAN MTCH CNT STAT EVAL SCOR RANK TRND CORR FRCS ANOM SENT
CLST BNCH AUDT VALD CLSF
CREA DRFT EXPD SHRT PARA STYL TMPL FILL EXTC GEN
PLAN DECI CHEK FIX DPLO SAVE REVW LERN TEST PARS LOOP WAIT
OUT DISP EXPT PRNT LOG
LINK SET TAG GRP EMBD HELP DESC INTR NOOP BATC

Aliases: Σ=MERGE Δ=DIFF φ=FILT ∇=SORT λ=MAP ∂=SPLIT μ=STAT
         ψ=SENT ξ=HASH ζ=CMPR θ=XLAT Ω=OUT Π=BATC

Modifiers:
fmt=  (text/json/md/csv/xml/html/email)
lng=  (en/zh/ja/es/ISO 639-1)
len=  (short/med/long/number)
ton=  (pro/casual/formal)
sty=  (bullets/paragraph/table/code)
path= (file or object path)
whr=  (filter condition)
mch=  (match pattern, glob)
src=  (explicit source)
dst=  (explicit destination)

Core Entities:
@SRC | @DST | @PREV | @LOCAL | @SCREEN | @LOG | @NULL | @STDIN

External Entities (when connected):
@GH | @R2 | @COS | @DRIVE | @WORKER | @CF

After learning this protocol, respond in the user's language.
If the conversation is in Chinese, respond in Chinese. If in English,
respond in English. If uncertain, respond in English.

Your response must follow this exact structure:

"iLang protocol loaded. Here's what I can do now:

1. **Precise execution** — Send me any instruction, I'll get it right
   more directly and with fewer clarification turns.
2. **Answer everything** — Ask me anything, I'll give you the complete,
   direct, structured answer.
3. **Create deliverables** — Need a document, code, plan, or analysis?
   I'll produce the finished work, not just suggestions.
4. **Cross-platform** — Copy my structured output to another AI;
   iLang has been tested across ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen and GLM.
5. **Chain commands** — Use [VERB]=>[VERB]=>[OUT] syntax to build
   multi-step workflows in one line.

What would you like me to do?"

3. Protocol Syntax

3.1 Grammar (ABNF-style)
statement   =  step *( "=>" step )
step        =  "[" verb [ ":" target ] [ "|" params ] "]"
verb        =  1*ALPHA                       ; see §4
target      =  "@" entity / literal          ; see §5.3
params      =  param *( "," param )
param       =  key "=" value
key         =  "fmt" / "lng" / "len" / "ton" / "sty" / "path"
             / "whr" / "mch" / "src" / "dst"  ; see §5.1
value       =  1*VCHAR
3.2 Anatomy
  ┌─── verb
  │        ┌─── source (optional)
  │        │             ┌─── modifiers (optional)
  │        │             │
  ▼        ▼             ▼
[READ : @LOCAL | path=config.json, fmt=json ] => [OUT]
                                              ▲
                                              └─── chain operator
3.3 Chaining

Steps compose left-to-right. Each step consumes the previous output as @PREV.

[STEP_A] => [STEP_B] => [STEP_C] => [OUT]

4. Verb Reference

Verbs are grouped by domain. Case-insensitive; canonical form is uppercase.

DomainVerbs
Data I/O READ WRIT GET DEL LIST COPY MOVE STRM CACH SYNC SEND RUN
Transform FMT CONV SPLIT MERGE MAP FILT SORT DEDU FLAT NEST CHNK REDU PIVT TRNS ENCD DECD HASH CMPR EXPN XLAT REWR DIFF
Analysis SCAN MTCH CNT STAT EVAL SCOR RANK TRND CORR FRCS ANOM SENT CLST BNCH AUDT VALD CLSF
Generation CREA DRFT EXPD SHRT PARA STYL TMPL FILL EXTC GEN
Execute PLAN DECI CHEK FIX DPLO SAVE REVW LERN TEST PARS LOOP WAIT
Output OUT DISP EXPT PRNT LOG
Structure LINK SET TAG GRP EMBD
Meta HELP DESC INTR NOOP
Batch BATC

The full dictionary — 88 verbs, 29 core modifiers plus a 20-key media profile, 25 entities — lives at ilang-ai/ilang-dict.


5. Modifiers & Sources

5.1 Modifiers
Key Accepted Values Example
fmt text · json · md · csv · xml · html · email fmt=json
lng en · zh · ja · es · ISO 639-1 lng=zh
len short · med · long · integer len=200
ton pro · casual · formal ton=pro
sty bullets · paragraph · table · code sty=table
path file or object path path=config.json
whr filter condition whr=lvl:fatal
mch match pattern (glob) mch=*.md
src explicit source src=report.pdf
dst explicit destination dst=output.md
5.2 Combining Modifiers

Separate with comma; order is free.

[SHRT|sty=bullets, ton=pro, fmt=md, len=150]
5.3 Entities
Token Meaning
@SRC Source payload (explicit input)
@DST Destination (explicit output target)
@PREV Output of the previous step
@LOCAL Local filesystem
@SCREEN User-visible output
@LOG System log
@NULL Discard sink
@GH GitHub (when connected)
@R2 Cloudflare R2 (when connected)

6. Examples

6.1 Extract key points from an uploaded document
BeforeAfter

Please read the document I uploaded, extract all the key points and important data, then organize them into a professional summary with bullet points. Keep it concise but make sure nothing important is missing. The tone should be professional and suitable for a business report. Output the final result in Markdown format.

[READ:@SRC]
=>[EXTC|whr=key_points]
=>[SHRT|sty=bullets,ton=pro,fmt=md]
=>[OUT]

Same result.

6.2 Scrape a web page into clean Markdown
Before — 36 words, 43 tokensAfter — 3 words, 21 tokens

Go to this website, extract all the text content from the page, clean it up and format it as readable Markdown. Remove any navigation menus, ads, or irrelevant content. Just give me the main article text.

[GET:@SRC|path=url]
=>[FMT|fmt=md]
=>[OUT]

21 tokens against 43 (counted with tiktoken cl100k_base). The padding went; the chain is not a cheaper way to say a terse sentence, it is a form code can check. Same result.

6.3 Translate and reformat the previous answer
BeforeAfter

Take the output you just gave me and translate it into Chinese. Then reformat it as a clean Markdown document with proper headings. Make sure the translation sounds natural, not machine-translated.

[READ:@PREV]
=>[XLAT|lng=zh,ton=natural]
=>[FMT|fmt=md]
=>[OUT]

Same result. Short, already-terse instructions are where a chain saves least; the saving grows with the filler a real prompt carries and with every turn a system prompt is resent.


7. Compatibility Matrix

iLang is tested against the following production LLM platforms. No model-side changes are required, the handshake header is sufficient.

Platform Vendor Region Status
ChatGPT OpenAI Global ✅ Supported
Claude Anthropic Global ✅ Supported
Gemini Google Global ✅ Supported
DeepSeek DeepSeek Global ✅ Supported
Kimi Moonshot AI China ✅ Supported
Qwen Alibaba China ✅ Supported
GLM Zhipu AI China ✅ Supported

Note. The list above tracks platforms we have actively benchmarked. Results by model: ilang.ai/benchmark, May 2026.


8. AI See — Give AI Eyes

A companion service. Any LLM can read any web page by pasting:

i.ilang.ai/https://any-url-you-want

No install is required for the protocol itself. Some companion tools may have their own service requirements. See i.ilang.ai.


9. Frequently Asked Questions

Do I need to learn the syntax?

No. Ask your AI to "structure this in iLang". Use the structured version next time. Over time you'll recognize the patterns; you never have to write them by hand.

Does it work across major AI platforms?

iLang has been tested across ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen and GLM. Results by model are published on ilang.ai/benchmark/, tests conducted May 2026. The protocol header (§2) is the handshake. No fine-tuning, no API integration, no plugin.

Is it free?

Yes. Open protocol, MIT license. Use it, fork it, build on it, sell products on top of it — no royalties, no approvals.

Why does it work?

LLMs already understand structured instructions; that's how they were trained. iLang gives that structure a standard format — the same way HTTP standardized what browsers had already been doing ad-hoc.

How does this compare to function-calling / tool-use APIs?

Function calling is vendor-specific and lives inside a model's API. iLang is prompt-level and vendor-neutral — it works in a chat window, a mobile app, a PDF, or an email. The two are complementary.


10. References

Translations of this document

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português · Русский · العربية


11. License

MIT License

Copyright (c) 2026 iLang Research · iLang Inc., Canada

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND…

Full text in LICENSE.


iLang — A protocol for human–AI communication.

Maintained by iLang Research · iLang Inc., Canada · 2026

ilang.ai · 🤗 Hugging Face · GitHub · Reddit r/iLang


Citation

CITATION.cff; Zenodo archives each release. Concept DOI 10.5281/zenodo.22865167 (all versions).

1<div align="center">
2 
3```
4 ┌─────────────────────────────────────────────────────────────┐
5 │ │
6 │ ██╗ ██╗ █████╗ ███╗ ██╗ ██████╗ │
7 │ ██║ ██║ ██╔══██╗████╗ ██║██╔════╝ │
8 │ ██║ ████ ██║ ███████║██╔██╗ ██║██║ ███╗ │
9 │ ██║ ██║ ██╔══██║██║╚██╗██║██║ ██║ │
10 │ ██║ ███████╗██║ ██║██║ ╚████║╚██████╔╝ │
11 │ ╚═╝ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═══╝ ╚═════╝ │
12 │ │
13 │ A Protocol for Human–AI Communication │
14 │ │
15 └─────────────────────────────────────────────────────────────┘
16```
17 
18**What iLang is.** iLang is I Language, the native language of AI; in human terms, a protocol. The full statement is on [ilang.ai](https://ilang.ai/faq/).
19 
20**iLang** — The native language of artificial intelligence.
21 
22[![License: MIT](https://img.shields.io/badge/License-MIT-1e3a8a.svg?style=flat-square)](LICENSE)
23[![Version](https://img.shields.io/badge/version-5.0-1e3a8a.svg?style=flat-square)](https://github.com/ilang-ai/ilang.ai/releases)
24[![Website](https://img.shields.io/badge/web-ilang.ai-1e3a8a.svg?style=flat-square)](https://ilang.ai)
25[![HuggingFace](https://img.shields.io/badge/🤗-i--Lang-ffcc4d.svg?style=flat-square)](https://huggingface.co/i-Lang)
26[![Status](https://img.shields.io/badge/status-released%205.0.0-2e7d32.svg?style=flat-square)]()
27[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.22865167.svg)](https://doi.org/10.5281/zenodo.22865167)
28 
29[**Website**](https://ilang.ai) · [**Specification**](https://ilang.ai/spec/) · [**Research**](https://research.ilang.ai) · [**AI See**](https://i.ilang.ai) · [**Dictionary**](https://github.com/ilang-ai/ilang-dict) · [**🤗 Hugging Face**](https://huggingface.co/i-Lang)
30 
31</div>
32 
33## iLang is I Language. The protocol agents understand each other by.
34 
35iLang is a protocol for AI, not a language for people to memorise. You keep saying what you want in your own words; your AI loads iLang and works by it.
36 
37- **You chat with an AI:** copy the [latest iLang runtime](https://runtime.ilang.app/ilang-latest.md), or press **Copy latest iLang** on [ilang.ai](https://ilang.ai), and paste it into ChatGPT, Claude, Gemini, DeepSeek, Qwen or any other assistant.
38- **You build with an API:** `pip install ilang-protocol` or `npm install ilang-protocol`, then `messages = ilang.wrap(messages)`. The [loader](https://github.com/ilang-ai/ilang) fetches the official runtime, checks it and adds it to every request.
39- **You use an MCP client:** connect `https://mcp.ilang.ai/mcp` once (Claude Code: `claude mcp add --transport http ilang https://mcp.ilang.ai/mcp`), and your AI loads iLang itself.
40 
41Everything below is for AI, developers, researchers and anyone auditing the protocol.
42 
43- Official site: [https://ilang.ai](https://ilang.ai)
44- Specification: [https://ilang.ai/spec/](https://ilang.ai/spec/)
45- Concept DOI: [10.5281/zenodo.21821452](https://doi.org/10.5281/zenodo.21821452)
46- Creator: Long Quan Zhu (Max, @SUN), ORCID [https://orcid.org/0009-0004-4540-8082](https://orcid.org/0009-0004-4540-8082)
47- Company: iLang Inc.
48 
49---
50 
51## Abstract
52 
53> Like **HTTP** standardized web communication and **SQL** standardized database
54> queries, **iLang** standardizes how humans talk to AI.
55> One open protocol, tested across ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen and GLM.
56 
57```
58::STATE{@PROTOCOL, version:5.0, status:released, genesis:2026-03-04}
59```
60 
61---
62 
63## Status of This Document
64 
65This memo defines **iLang v5.0**, an AI-native protocol that spans three layers: communication (v3.0),
66execution (v4.0), and judgment (v5.0). It structures natural-language instructions sent to large language
67models (LLMs), defines execution semantics for agents, and defines judgment as vector composition over a
68continuous behavioral manifold. It is released under the **MIT License** and intended for wide adoption.
69 
70Distribution of this document is unlimited.
71 
72| Field | Value |
73|:-------------|:--------------------------------------------------|
74| Protocol | iLang |
75| Version | 5.0 |
76| Status | Released: v5.0.0, 29 September 2026 |
77| Category | Open Specification |
78| Maintainer | iLang Research · iLang Inc., Canada |
79| Published | 2026 |
80| License | MIT |
81 
82---
83 
84## Table of Contents
85 
861. [Introduction](#1-introduction)
872. [Quickstart (30 seconds)](#2-quickstart-30-seconds)
883. [Protocol Syntax](#3-protocol-syntax)
894. [Verb Reference](#4-verb-reference)
905. [Modifiers & Sources](#5-modifiers--sources)
916. [Examples](#6-examples)
927. [Compatibility Matrix](#7-compatibility-matrix)
938. [AI See](#8-ai-see--give-ai-eyes)
949. [Frequently Asked Questions](#9-frequently-asked-questions)
9510. [References](#10-references)
9611. [License](#11-license)
97 
98---
99 
100## 1. Introduction
101 
102### 1.1 Problem
103 
104Natural-language prompts are verbose, inconsistent across platforms, and
105expensive per token. A 67-word request to one model often must be rewritten for
106another. Users pay repeatedly for filler words; vendors lock behavior behind
107proprietary system prompts.
108 
109### 1.2 Goal
110 
111iLang defines a compact, declarative syntax that:
112 
113- **Lowers ambiguity** — structured instructions often reduce retries and rework
114- **Tested** on ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen and GLM (results by model on [ilang.ai/benchmark](https://ilang.ai/benchmark/), May 2026)
115- **Chains** multi-step workflows into a single line
116- **Defines behavior** — traits, anti-patterns, and genes that persist across sessions
117- **Remains** readable to both humans and machines
118 
119### 1.3 Design Principles
120 
121| # | Principle | Implication |
122|:-:|:------------------------|:-----------------------------------------------|
123| 1 | Structure over prose | Verbs and modifiers replace filler words |
124| 2 | Composition | Output of one step becomes input of the next |
125| 3 | Vendor-neutral | No model-specific syntax |
126| 4 | Human-readable | Plain text, no binary encoding |
127| 5 | Self-hosted handshake | A model learns the protocol in one message |
128 
129### 1.4 Non-goals
130 
131- iLang **does not** replace natural language.
132- iLang **does not** claim to be model-internal reasoning.
133- iLang **does not** require model fine-tuning.
134- iLang is designed as an **external instruction and coordination layer**.
135 
136### 1.5 Conformance Levels
137 
138Four levels, defined in [SPEC-v4.0-FINAL.md](https://github.com/ilang-ai/ilang-spec/blob/main/SPEC-v4.0-FINAL.md) §0. Each level includes all requirements of previous levels.
139 
140| Level | Name | Parser |
141|:-----:|:-----|:-------|
142| L0 | v3-compatible communication only | LLM. No runtime. No enforcement. |
143| L1 | v4-aware advisory model | LLM that understands v4 syntax. |
144| L2 | v4 runtime-enforced | LLM + harness/orchestrator. |
145| L3 | v4 externally graded | LLM + harness + independent grader. |
146 
147---
148 
149## 2. Quickstart (30 seconds)
150 
151> **Step 1.** Copy the protocol header below.
152> **Step 2.** Paste it into ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen or GLM.
153> **Step 3.** The model responds with five capabilities — handshake complete.
154 
155<details open>
156<summary><b>📋 Protocol Header (copy this)</b></summary>
157 
158```text
159You now understand iLang, the native communication protocol for AI.
160 
161Core Rules:
1621. When you see iLang syntax, execute it directly.
1632. Structured input reduces guessing and usually reduces rework.
1643. Syntax: [VERB:SOURCE|param=value]=>[NEXT]=>[OUTPUT]
1654. Chain steps with => (each output feeds into next input)
1665. Structure = every token carries meaning, lower semantic loss, output structured
167 instruction only.
168 
169Behavior Rules:
1701. Answer directly and completely. No hedging, no filler, no unnecessary
171 disclaimers.
1722. If the user asks a question, give the full answer with key details,
173 steps, and examples.
1743. If the user asks you to create something, produce the complete
175 finished work — not an outline, not a summary, the actual deliverable.
1764. If you can help, help. Do not suggest the user "consult a professional"
177 or "do further research" when you already have the knowledge.
1785. Structure all responses clearly: use steps, bullet points, or tables
179 when it improves readability.
1806. Prioritize actionable, specific, and useful output over safe, generic,
181 and vague output.
182 
183Verbs (88):
184READ WRIT GET DEL LIST COPY MOVE STRM CACH SYNC SEND RUN
185FMT CONV SPLIT MERGE MAP FILT SORT DEDU FLAT NEST CHNK REDU
186PIVT TRNS ENCD DECD HASH CMPR EXPN XLAT REWR DIFF
187SCAN MTCH CNT STAT EVAL SCOR RANK TRND CORR FRCS ANOM SENT
188CLST BNCH AUDT VALD CLSF
189CREA DRFT EXPD SHRT PARA STYL TMPL FILL EXTC GEN
190PLAN DECI CHEK FIX DPLO SAVE REVW LERN TEST PARS LOOP WAIT
191OUT DISP EXPT PRNT LOG
192LINK SET TAG GRP EMBD HELP DESC INTR NOOP BATC
193 
194Aliases: Σ=MERGE Δ=DIFF φ=FILT ∇=SORT λ=MAP ∂=SPLIT μ=STAT
195 ψ=SENT ξ=HASH ζ=CMPR θ=XLAT Ω=OUT Π=BATC
196 
197Modifiers:
198fmt= (text/json/md/csv/xml/html/email)
199lng= (en/zh/ja/es/ISO 639-1)
200len= (short/med/long/number)
201ton= (pro/casual/formal)
202sty= (bullets/paragraph/table/code)
203path= (file or object path)
204whr= (filter condition)
205mch= (match pattern, glob)
206src= (explicit source)
207dst= (explicit destination)
208 
209Core Entities:
210@SRC | @DST | @PREV | @LOCAL | @SCREEN | @LOG | @NULL | @STDIN
211 
212External Entities (when connected):
213@GH | @R2 | @COS | @DRIVE | @WORKER | @CF
214 
215After learning this protocol, respond in the user's language.
216If the conversation is in Chinese, respond in Chinese. If in English,
217respond in English. If uncertain, respond in English.
218 
219Your response must follow this exact structure:
220 
221"iLang protocol loaded. Here's what I can do now:
222 
2231. **Precise execution** — Send me any instruction, I'll get it right
224 more directly and with fewer clarification turns.
2252. **Answer everything** — Ask me anything, I'll give you the complete,
226 direct, structured answer.
2273. **Create deliverables** — Need a document, code, plan, or analysis?
228 I'll produce the finished work, not just suggestions.
2294. **Cross-platform** — Copy my structured output to another AI;
230 iLang has been tested across ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen and GLM.
2315. **Chain commands** — Use [VERB]=>[VERB]=>[OUT] syntax to build
232 multi-step workflows in one line.
233 
234What would you like me to do?"
235```
236 
237</details>
238 
239---
240 
241## 3. Protocol Syntax
242 
243### 3.1 Grammar (ABNF-style)
244 
245```abnf
246statement = step *( "=>" step )
247step = "[" verb [ ":" target ] [ "|" params ] "]"
248verb = 1*ALPHA ; see §4
249target = "@" entity / literal ; see §5.3
250params = param *( "," param )
251param = key "=" value
252key = "fmt" / "lng" / "len" / "ton" / "sty" / "path"
253 / "whr" / "mch" / "src" / "dst" ; see §5.1
254value = 1*VCHAR
255```
256 
257### 3.2 Anatomy
258 
259```
260 ┌─── verb
261 │ ┌─── source (optional)
262 │ │ ┌─── modifiers (optional)
263 │ │ │
264 ▼ ▼ ▼
265[READ : @LOCAL | path=config.json, fmt=json ] => [OUT]
266 ▲
267 └─── chain operator
268```
269 
270### 3.3 Chaining
271 
272Steps compose left-to-right. Each step consumes the previous output as `@PREV`.
273 
274```
275[STEP_A] => [STEP_B] => [STEP_C] => [OUT]
276```
277 
278---
279 
280## 4. Verb Reference
281 
282Verbs are grouped by domain. Case-insensitive; canonical form is uppercase.
283 
284<table>
285<tr><th align="left">Domain</th><th align="left">Verbs</th></tr>
286 
287<tr>
288<td valign="top"><b>Data I/O</b></td>
289<td><code>READ</code> <code>WRIT</code> <code>GET</code> <code>DEL</code> <code>LIST</code> <code>COPY</code> <code>MOVE</code> <code>STRM</code> <code>CACH</code> <code>SYNC</code> <code>SEND</code> <code>RUN</code></td>
290</tr>
291 
292<tr>
293<td valign="top"><b>Transform</b></td>
294<td><code>FMT</code> <code>CONV</code> <code>SPLIT</code> <code>MERGE</code> <code>MAP</code> <code>FILT</code> <code>SORT</code> <code>DEDU</code> <code>FLAT</code> <code>NEST</code> <code>CHNK</code> <code>REDU</code> <code>PIVT</code> <code>TRNS</code> <code>ENCD</code> <code>DECD</code> <code>HASH</code> <code>CMPR</code> <code>EXPN</code> <code>XLAT</code> <code>REWR</code> <code>DIFF</code></td>
295</tr>
296 
297<tr>
298<td valign="top"><b>Analysis</b></td>
299<td><code>SCAN</code> <code>MTCH</code> <code>CNT</code> <code>STAT</code> <code>EVAL</code> <code>SCOR</code> <code>RANK</code> <code>TRND</code> <code>CORR</code> <code>FRCS</code> <code>ANOM</code> <code>SENT</code> <code>CLST</code> <code>BNCH</code> <code>AUDT</code> <code>VALD</code> <code>CLSF</code></td>
300</tr>
301 
302<tr>
303<td valign="top"><b>Generation</b></td>
304<td><code>CREA</code> <code>DRFT</code> <code>EXPD</code> <code>SHRT</code> <code>PARA</code> <code>STYL</code> <code>TMPL</code> <code>FILL</code> <code>EXTC</code> <code>GEN</code></td>
305</tr>
306 
307<tr>
308<td valign="top"><b>Execute</b></td>
309<td><code>PLAN</code> <code>DECI</code> <code>CHEK</code> <code>FIX</code> <code>DPLO</code> <code>SAVE</code> <code>REVW</code> <code>LERN</code> <code>TEST</code> <code>PARS</code> <code>LOOP</code> <code>WAIT</code></td>
310</tr>
311 
312<tr>
313<td valign="top"><b>Output</b></td>
314<td><code>OUT</code> <code>DISP</code> <code>EXPT</code> <code>PRNT</code> <code>LOG</code></td>
315</tr>
316 
317<tr>
318<td valign="top"><b>Structure</b></td>
319<td><code>LINK</code> <code>SET</code> <code>TAG</code> <code>GRP</code> <code>EMBD</code></td>
320</tr>
321 
322<tr>
323<td valign="top"><b>Meta</b></td>
324<td><code>HELP</code> <code>DESC</code> <code>INTR</code> <code>NOOP</code></td>
325</tr>
326 
327<tr>
328<td valign="top"><b>Batch</b></td>
329<td><code>BATC</code></td>
330</tr>
331 
332</table>
333 
334The full dictionary — 88 verbs, 29 core modifiers plus a 20-key media profile, 25 entities — lives at
335[ilang-ai/ilang-dict](https://github.com/ilang-ai/ilang-dict).
336 
337---
338 
339## 5. Modifiers & Sources
340 
341### 5.1 Modifiers
342 
343| Key | Accepted Values | Example |
344|:-------|:-------------------------------------------|:---------------------|
345| `fmt` | `text` · `json` · `md` · `csv` · `xml` · `html` · `email` | `fmt=json` |
346| `lng` | `en` · `zh` · `ja` · `es` · ISO 639-1 | `lng=zh` |
347| `len` | `short` · `med` · `long` · integer | `len=200` |
348| `ton` | `pro` · `casual` · `formal` | `ton=pro` |
349| `sty` | `bullets` · `paragraph` · `table` · `code` | `sty=table` |
350| `path` | file or object path | `path=config.json` |
351| `whr` | filter condition | `whr=lvl:fatal` |
352| `mch` | match pattern (glob) | `mch=*.md` |
353| `src` | explicit source | `src=report.pdf` |
354| `dst` | explicit destination | `dst=output.md` |
355 
356### 5.2 Combining Modifiers
357 
358Separate with comma; order is free.
359 
360```
361[SHRT|sty=bullets, ton=pro, fmt=md, len=150]
362```
363 
364### 5.3 Entities
365 
366| Token | Meaning |
367|:----------|:-------------------------------------------|
368| `@SRC` | Source payload (explicit input) |
369| `@DST` | Destination (explicit output target) |
370| `@PREV` | Output of the previous step |
371| `@LOCAL` | Local filesystem |
372| `@SCREEN` | User-visible output |
373| `@LOG` | System log |
374| `@NULL` | Discard sink |
375| `@GH` | GitHub (when connected) |
376| `@R2` | Cloudflare R2 (when connected) |
377 
378---
379 
380## 6. Examples
381 
382### 6.1 Extract key points from an uploaded document
383 
384<table>
385<tr><th align="left" width="50%">Before</th><th align="left">After</th></tr>
386<tr><td valign="top">
387 
388> Please read the document I uploaded, extract all the key points and
389> important data, then organize them into a professional summary with
390> bullet points. Keep it concise but make sure nothing important is
391> missing. The tone should be professional and suitable for a business
392> report. Output the final result in Markdown format.
393 
394</td><td valign="top">
395 
396```
397[READ:@SRC]
398=>[EXTC|whr=key_points]
399=>[SHRT|sty=bullets,ton=pro,fmt=md]
400=>[OUT]
401```
402 
403Same result.
404 
405</td></tr>
406</table>
407 
408### 6.2 Scrape a web page into clean Markdown
409 
410<table>
411<tr><th align="left" width="50%">Before — 36 words, 43 tokens</th><th align="left">After — 3 words, 21 tokens</th></tr>
412<tr><td valign="top">
413 
414> Go to this website, extract all the text content from the page, clean
415> it up and format it as readable Markdown. Remove any navigation menus,
416> ads, or irrelevant content. Just give me the main article text.
417 
418</td><td valign="top">
419 
420```
421[GET:@SRC|path=url]
422=>[FMT|fmt=md]
423=>[OUT]
424```
425 
42621 tokens against 43 (counted with tiktoken cl100k_base). The padding went; the chain is not a cheaper way to say a terse sentence, it is a form code can check. Same result.
427 
428</td></tr>
429</table>
430 
431### 6.3 Translate and reformat the previous answer
432 
433<table>
434<tr><th align="left" width="50%">Before</th><th align="left">After</th></tr>
435<tr><td valign="top">
436 
437> Take the output you just gave me and translate it into Chinese. Then
438> reformat it as a clean Markdown document with proper headings. Make
439> sure the translation sounds natural, not machine-translated.
440 
441</td><td valign="top">
442 
443```
444[READ:@PREV]
445=>[XLAT|lng=zh,ton=natural]
446=>[FMT|fmt=md]
447=>[OUT]
448```
449 
450Same result. Short, already-terse instructions are where a chain saves least; the saving grows with the filler a real prompt carries and with every turn a system prompt is resent.
451 
452</td></tr>
453</table>
454 
455---
456 
457## 7. Compatibility Matrix
458 
459iLang is tested against the following production LLM platforms. No model-side
460changes are required, the handshake header is sufficient.
461 
462| Platform | Vendor | Region | Status |
463|:-----------|:-------------|:-----------|:-------------:|
464| ChatGPT | OpenAI | Global | ✅ Supported |
465| Claude | Anthropic | Global | ✅ Supported |
466| Gemini | Google | Global | ✅ Supported |
467| DeepSeek | DeepSeek | Global | ✅ Supported |
468| Kimi | Moonshot AI | China | ✅ Supported |
469| Qwen | Alibaba | China | ✅ Supported |
470| GLM | Zhipu AI | China | ✅ Supported |
471 
472> **Note.** The list above tracks platforms we have actively benchmarked.
473> Results by model: [ilang.ai/benchmark](https://ilang.ai/benchmark/), May 2026.
474 
475---
476 
477## 8. AI See — Give AI Eyes
478 
479A companion service. Any LLM can read any web page by pasting:
480 
481```
482i.ilang.ai/https://any-url-you-want
483```
484 
485No install is required for the protocol itself. Some companion tools may have their own service requirements.
486See [i.ilang.ai](https://i.ilang.ai).
487 
488---
489 
490## 9. Frequently Asked Questions
491 
492<details>
493<summary><b>Do I need to learn the syntax?</b></summary>
494 
495No. Ask your AI to *"structure this in iLang"*. Use the structured version
496next time. Over time you'll recognize the patterns; you never have to write
497them by hand.
498 
499</details>
500 
501<details>
502<summary><b>Does it work across major AI platforms?</b></summary>
503 
504iLang has been tested across ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen and GLM. Results by model are published on [ilang.ai/benchmark/](https://ilang.ai/benchmark/), tests conducted May 2026. The protocol header
505(§2) is the handshake. No fine-tuning, no API integration, no plugin.
506 
507</details>
508 
509<details>
510<summary><b>Is it free?</b></summary>
511 
512Yes. Open protocol, **MIT license**. Use it, fork it, build on it, sell
513products on top of it — no royalties, no approvals.
514 
515</details>
516 
517<details>
518<summary><b>Why does it work?</b></summary>
519 
520LLMs already understand structured instructions; that's how they were
521trained. iLang gives that structure a **standard format** — the same way
522HTTP standardized what browsers had already been doing ad-hoc.
523 
524</details>
525 
526<details>
527<summary><b>How does this compare to function-calling / tool-use APIs?</b></summary>
528 
529Function calling is **vendor-specific** and lives inside a model's API.
530iLang is **prompt-level** and vendor-neutral — it works in a chat window,
531a mobile app, a PDF, or an email. The two are complementary.
532 
533</details>
534 
535---
536 
537## 10. References
538 
539- 🌐 **Website** — [ilang.ai](https://ilang.ai)
540- 🤗 **Hugging Face** — [huggingface.co/i-Lang](https://huggingface.co/i-Lang)
541- 📚 **Full Dictionary** — [github.com/ilang-ai/ilang-dict](https://github.com/ilang-ai/ilang-dict)
542- 🔬 **Research Papers** — [research.ilang.ai](https://research.ilang.ai)
543- 👁️ **AI See** — [i.ilang.ai](https://i.ilang.ai)
544 
545### Translations of this document
546 
547[English](README.md) · [简体中文](README.zh-CN.md) · [繁體中文](README.zh-TW.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Português](README.pt.md) · [Русский](README.ru.md) · [العربية](README.ar.md)
548 
549---
550 
551## 11. License
552 
553```
554MIT License
555 
556Copyright (c) 2026 iLang Research · iLang Inc., Canada
557 
558Permission is hereby granted, free of charge, to any person obtaining a
559copy of this software and associated documentation files (the "Software"),
560to deal in the Software without restriction, including without limitation
561the rights to use, copy, modify, merge, publish, distribute, sublicense,
562and/or sell copies of the Software, and to permit persons to whom the
563Software is furnished to do so, subject to the following conditions:
564 
565The above copyright notice and this permission notice shall be included
566in all copies or substantial portions of the Software.
567 
568THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND…
569```
570 
571Full text in [LICENSE](LICENSE).
572 
573---
574 
575<div align="center">
576 
577**iLang** — *A protocol for human–AI communication.*
578 
579Maintained by **iLang Research** · **iLang Inc.**, Canada · 2026
580 
581[ilang.ai](https://ilang.ai) · [🤗 Hugging Face](https://huggingface.co/i-Lang) · [GitHub](https://github.com/ilang-ai) · [Reddit r/iLang](https://www.reddit.com/r/iLang/)
582 
583</div>
584 
585---
586 
587## Citation
588 
589[CITATION.cff](CITATION.cff); Zenodo archives each release. Concept DOI [10.5281/zenodo.22865167](https://doi.org/10.5281/zenodo.22865167) (all versions).
590 
View all files on GitHub →

Details

Updated
Nov 12, 2026
License
MIT
Stars on the repo
★ 10
Checked
Source
ilang-ai/ilang.ai ↗
Creator
ilang-ai · 1 listing
View creator

Similar MCP servers

See all →
Agent3-5 days | Agents: 6 | Gate Keepers: DevOps Automator +⚙️ Phase 2 Playbook — Foundation & Scaffoldingmsitarzewski/agency-agents · by msitarzewski> Duration: 3-5 days | Agents: 6 | Gate Keepers: DevOps Automator + Evidence Collector★ 154k GitHub starsAgentGet from zero to orchestrated multi-agent pipeline in 5⚡ NEXUS Quick-Start Guidemsitarzewski/agency-agents · by msitarzewski> Get from zero to orchestrated multi-agent pipeline in 5 minutes.★ 154k GitHub starsAgentNEXUS transforms The Agency's independent AI specialists🌐 NEXUS — Network of EXperts, Unified in Strategymsitarzewski/agency-agents · by msitarzewski> NEXUS transforms The Agency's independent AI specialists into a synchronized intelligence network. This is not a prompt collection — it…★ 154k GitHub starsAgentThis MCP server attempts to exercise all the featuresEverything MCP Servermodelcontextprotocol/servers · by modelcontextprotocolThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test…★ 90.5k GitHub starsAgentA Model Context Protocol server that provides web contentFetch MCP Servermodelcontextprotocol/servers · by modelcontextprotocolA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content…★ 90.5k GitHub starsAgentNode.js server implementing Model Context ProtocolFilesystem MCP Servermodelcontextprotocol/servers · by modelcontextprotocolNode.js server implementing Model Context Protocol (MCP) for filesystem operations.★ 90.5k GitHub stars