AI-native communication protocol for structured human-to-AI
ilang.ai

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/
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.
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-protocolornpm install ilang-protocol, thenmessages = 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/mcponce (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.
- Official site: https://ilang.ai
- Specification: https://ilang.ai/spec/
- Concept DOI: 10.5281/zenodo.21821452
- Creator: Long Quan Zhu (Max, @SUN), ORCID https://orcid.org/0009-0004-4540-8082
- Company: iLang Inc.
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
- Introduction
- Quickstart (30 seconds)
- Protocol Syntax
- Verb Reference
- Modifiers & Sources
- Examples
- Compatibility Matrix
- AI See
- Frequently Asked Questions
- References
- 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.
| Domain | Verbs |
|---|---|
| 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
| Before | After |
|---|---|
|
Same result. |
6.2 Scrape a web page into clean Markdown
| Before — 36 words, 43 tokens | After — 3 words, 21 tokens |
|---|---|
|
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
| Before | After |
|---|---|
|
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 | 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
- 🌐 Website — ilang.ai
- 🤗 Hugging Face — huggingface.co/i-Lang
- 📚 Full Dictionary — github.com/ilang-ai/ilang-dict
- 🔬 Research Papers — research.ilang.ai
- 👁️ AI See — i.ilang.ai
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
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]. |
| 19 | |
| 20 | **iLang** — The native language of artificial intelligence. |
| 21 | |
| 22 | [![License: MIT]](LICENSE) |
| 23 | [![Version]](https://github.com/ilang-ai/ilang.ai/releases) |
| 24 | [![Website]](https://ilang.ai) |
| 25 | [![HuggingFace]](https://huggingface.co/i-Lang) |
| 26 | [![Status]]() |
| 27 | [![DOI]](https://doi.org/10.5281/zenodo.22865167) |
| 28 | |
| 29 | [**Website**] · [**Specification**] · [**Research**] · [**AI See**] · [**Dictionary**] · [**🤗 Hugging Face**] |
| 30 | |
| 31 | </div> |
| 32 | |
| 33 | ## iLang is I Language. The protocol agents understand each other by. |
| 34 | |
| 35 | 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. |
| 36 | |
| 37 | **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. |
| 38 | **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. |
| 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 | |
| 41 | Everything below is for AI, developers, researchers and anyone auditing the protocol. |
| 42 | |
| 43 | Official site: [https://ilang.ai] |
| 44 | Specification: [https://ilang.ai/spec/] |
| 45 | Concept DOI: [10.5281/zenodo.21821452] |
| 46 | Creator: Long Quan Zhu (Max, @SUN), ORCID [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 | |
| 65 | This memo defines **iLang v5.0**, an AI-native protocol that spans three layers: communication (v3.0), |
| 66 | execution (v4.0), and judgment (v5.0). It structures natural-language instructions sent to large language |
| 67 | models (LLMs), defines execution semantics for agents, and defines judgment as vector composition over a |
| 68 | continuous behavioral manifold. It is released under the **MIT License** and intended for wide adoption. |
| 69 | |
| 70 | Distribution 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 | |
| 86 | [Introduction] |
| 87 | [Quickstart (30 seconds)] |
| 88 | [Protocol Syntax] |
| 89 | [Verb Reference] |
| 90 | [Modifiers & Sources] |
| 91 | [Examples] |
| 92 | [Compatibility Matrix] |
| 93 | [AI See] |
| 94 | [Frequently Asked Questions] |
| 95 | [References] |
| 96 | [License] |
| 97 | |
| 98 | |
| 99 | |
| 100 | ## 1. Introduction |
| 101 | |
| 102 | ### 1.1 Problem |
| 103 | |
| 104 | Natural-language prompts are verbose, inconsistent across platforms, and |
| 105 | expensive per token. A 67-word request to one model often must be rewritten for |
| 106 | another. Users pay repeatedly for filler words; vendors lock behavior behind |
| 107 | proprietary system prompts. |
| 108 | |
| 109 | ### 1.2 Goal |
| 110 | |
| 111 | iLang 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], 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 | |
| 138 | Four levels, defined in [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 | |
| 159 | You now understand iLang, the native communication protocol for AI. |
| 160 | |
| 161 | Core Rules: |
| 162 | 1. When you see iLang syntax, execute it directly. |
| 163 | 2. Structured input reduces guessing and usually reduces rework. |
| 164 | 3. Syntax: [VERB:SOURCE|param=value]=>[NEXT]=>[OUTPUT] |
| 165 | 4. Chain steps with => (each output feeds into next input) |
| 166 | 5. Structure = every token carries meaning, lower semantic loss, output structured |
| 167 | instruction only. |
| 168 | |
| 169 | Behavior Rules: |
| 170 | 1. Answer directly and completely. No hedging, no filler, no unnecessary |
| 171 | disclaimers. |
| 172 | 2. If the user asks a question, give the full answer with key details, |
| 173 | steps, and examples. |
| 174 | 3. If the user asks you to create something, produce the complete |
| 175 | finished work — not an outline, not a summary, the actual deliverable. |
| 176 | 4. If you can help, help. Do not suggest the user "consult a professional" |
| 177 | or "do further research" when you already have the knowledge. |
| 178 | 5. Structure all responses clearly: use steps, bullet points, or tables |
| 179 | when it improves readability. |
| 180 | 6. Prioritize actionable, specific, and useful output over safe, generic, |
| 181 | and vague output. |
| 182 | |
| 183 | Verbs (88): |
| 184 | READ WRIT GET DEL LIST COPY MOVE STRM CACH SYNC SEND RUN |
| 185 | FMT CONV SPLIT MERGE MAP FILT SORT DEDU FLAT NEST CHNK REDU |
| 186 | PIVT TRNS ENCD DECD HASH CMPR EXPN XLAT REWR DIFF |
| 187 | SCAN MTCH CNT STAT EVAL SCOR RANK TRND CORR FRCS ANOM SENT |
| 188 | CLST BNCH AUDT VALD CLSF |
| 189 | CREA DRFT EXPD SHRT PARA STYL TMPL FILL EXTC GEN |
| 190 | PLAN DECI CHEK FIX DPLO SAVE REVW LERN TEST PARS LOOP WAIT |
| 191 | OUT DISP EXPT PRNT LOG |
| 192 | LINK SET TAG GRP EMBD HELP DESC INTR NOOP BATC |
| 193 | |
| 194 | Aliases: Σ=MERGE Δ=DIFF φ=FILT ∇=SORT λ=MAP ∂=SPLIT μ=STAT |
| 195 | ψ=SENT ξ=HASH ζ=CMPR θ=XLAT Ω=OUT Π=BATC |
| 196 | |
| 197 | Modifiers: |
| 198 | fmt= (text/json/md/csv/xml/html/email) |
| 199 | lng= (en/zh/ja/es/ISO 639-1) |
| 200 | len= (short/med/long/number) |
| 201 | ton= (pro/casual/formal) |
| 202 | sty= (bullets/paragraph/table/code) |
| 203 | path= (file or object path) |
| 204 | whr= (filter condition) |
| 205 | mch= (match pattern, glob) |
| 206 | src= (explicit source) |
| 207 | dst= (explicit destination) |
| 208 | |
| 209 | Core Entities: |
| 210 | @SRC | @DST | @PREV | @LOCAL | @SCREEN | @LOG | @NULL | @STDIN |
| 211 | |
| 212 | External Entities (when connected): |
| 213 | @GH | @R2 | @COS | @DRIVE | @WORKER | @CF |
| 214 | |
| 215 | After learning this protocol, respond in the user's language. |
| 216 | If the conversation is in Chinese, respond in Chinese. If in English, |
| 217 | respond in English. If uncertain, respond in English. |
| 218 | |
| 219 | Your response must follow this exact structure: |
| 220 | |
| 221 | "iLang protocol loaded. Here's what I can do now: |
| 222 | |
| 223 | 1. **Precise execution** — Send me any instruction, I'll get it right |
| 224 | more directly and with fewer clarification turns. |
| 225 | 2. **Answer everything** — Ask me anything, I'll give you the complete, |
| 226 | direct, structured answer. |
| 227 | 3. **Create deliverables** — Need a document, code, plan, or analysis? |
| 228 | I'll produce the finished work, not just suggestions. |
| 229 | 4. **Cross-platform** — Copy my structured output to another AI; |
| 230 | iLang has been tested across ChatGPT, Claude, Gemini, DeepSeek, Kimi, Qwen and GLM. |
| 231 | 5. **Chain commands** — Use [VERB]=>[VERB]=>[OUT] syntax to build |
| 232 | multi-step workflows in one line. |
| 233 | |
| 234 | What 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 | |
| 246 | statement = step *( "=>" step ) |
| 247 | step = "[" verb [ ":" target ] [ "|" params ] "]" |
| 248 | verb = 1*ALPHA ; see §4 |
| 249 | target = "@" entity / literal ; see §5.3 |
| 250 | params = param *( "," param ) |
| 251 | param = key "=" value |
| 252 | key = "fmt" / "lng" / "len" / "ton" / "sty" / "path" |
| 253 | / "whr" / "mch" / "src" / "dst" ; see §5.1 |
| 254 | value = 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 | |
| 272 | Steps 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 | |
| 282 | Verbs 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 | |
| 334 | The full dictionary — 88 verbs, 29 core modifiers plus a 20-key media profile, 25 entities — lives at |
| 335 | [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 | |
| 358 | Separate 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 | |
| 403 | Same 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 | |
| 426 | 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. |
| 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 | |
| 450 | 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. |
| 451 | |
| 452 | </td></tr> |
| 453 | </table> |
| 454 | |
| 455 | |
| 456 | |
| 457 | ## 7. Compatibility Matrix |
| 458 | |
| 459 | iLang is tested against the following production LLM platforms. No model-side |
| 460 | changes 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], May 2026. |
| 474 | |
| 475 | |
| 476 | |
| 477 | ## 8. AI See — Give AI Eyes |
| 478 | |
| 479 | A companion service. Any LLM can read any web page by pasting: |
| 480 | |
| 481 | |
| 482 | i.ilang.ai/https://any-url-you-want |
| 483 | |
| 484 | |
| 485 | No install is required for the protocol itself. Some companion tools may have their own service requirements. |
| 486 | See [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 | |
| 495 | No. Ask your AI to *"structure this in iLang"*. Use the structured version |
| 496 | next time. Over time you'll recognize the patterns; you never have to write |
| 497 | them by hand. |
| 498 | |
| 499 | </details> |
| 500 | |
| 501 | <details> |
| 502 | <summary><b>Does it work across major AI platforms?</b></summary> |
| 503 | |
| 504 | 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 |
| 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 | |
| 512 | Yes. Open protocol, **MIT license**. Use it, fork it, build on it, sell |
| 513 | products on top of it — no royalties, no approvals. |
| 514 | |
| 515 | </details> |
| 516 | |
| 517 | <details> |
| 518 | <summary><b>Why does it work?</b></summary> |
| 519 | |
| 520 | LLMs already understand structured instructions; that's how they were |
| 521 | trained. iLang gives that structure a **standard format** — the same way |
| 522 | HTTP 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 | |
| 529 | Function calling is **vendor-specific** and lives inside a model's API. |
| 530 | iLang is **prompt-level** and vendor-neutral — it works in a chat window, |
| 531 | a 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] |
| 540 | 🤗 **Hugging Face** — [huggingface.co/i-Lang] |
| 541 | 📚 **Full Dictionary** — [github.com/ilang-ai/ilang-dict] |
| 542 | 🔬 **Research Papers** — [research.ilang.ai] |
| 543 | 👁️ **AI See** — [i.ilang.ai] |
| 544 | |
| 545 | ### Translations of this document |
| 546 | |
| 547 | [English] · [简体中文] · [繁體中文] · [日本語] · [한국어] · [Español] · [Français] · [Deutsch] · [Português] · [Русский] · [العربية] |
| 548 | |
| 549 | |
| 550 | |
| 551 | ## 11. License |
| 552 | |
| 553 | |
| 554 | MIT License |
| 555 | |
| 556 | Copyright (c) 2026 iLang Research · iLang Inc., Canada |
| 557 | |
| 558 | Permission is hereby granted, free of charge, to any person obtaining a |
| 559 | copy of this software and associated documentation files (the "Software"), |
| 560 | to deal in the Software without restriction, including without limitation |
| 561 | the rights to use, copy, modify, merge, publish, distribute, sublicense, |
| 562 | and/or sell copies of the Software, and to permit persons to whom the |
| 563 | Software is furnished to do so, subject to the following conditions: |
| 564 | |
| 565 | The above copyright notice and this permission notice shall be included |
| 566 | in all copies or substantial portions of the Software. |
| 567 | |
| 568 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND… |
| 569 | |
| 570 | |
| 571 | Full text in [LICENSE]. |
| 572 | |
| 573 | |
| 574 | |
| 575 | <div align="center"> |
| 576 | |
| 577 | **iLang** — *A protocol for human–AI communication.* |
| 578 | |
| 579 | Maintained by **iLang Research** · **iLang Inc.**, Canada · 2026 |
| 580 | |
| 581 | [ilang.ai] · [🤗 Hugging Face] · [GitHub] · [Reddit r/iLang] |
| 582 | |
| 583 | </div> |
| 584 | |
| 585 | |
| 586 | |
| 587 | ## Citation |
| 588 | |
| 589 | [CITATION.cff]; Zenodo archives each release. Concept DOI [10.5281/zenodo.22865167] (all versions). |
| 590 |
Details
- Updated
- Nov 12, 2026
- License
- MIT
- Stars on the repo
- ★ 10
- Checked
- Source
- ilang-ai/ilang.ai ↗
- Creator
- ilang-ai · 1 listing
Similar MCP servers
See all →
Agent3-5 days | Agents: 6 | Gate Keepers: DevOps Automator +⚙️ Phase 2 Playbook — Foundation & Scaffolding
AgentGet from zero to orchestrated multi-agent pipeline in 5⚡ NEXUS Quick-Start Guide
AgentNEXUS transforms The Agency's independent AI specialists🌐 NEXUS — Network of EXperts, Unified in Strategy
AgentThis MCP server attempts to exercise all the featuresEverything MCP Server
AgentA Model Context Protocol server that provides web contentFetch MCP Server
AgentNode.js server implementing Model Context ProtocolFilesystem MCP Server