Initial release: I-Lang protocol converter

README.md

@@ -1,14 +1,52 @@
 ---
-title: Ilang
+title: I-Lang Protocol
 emoji: ⚡
-colorFrom: purple
-colorTo: gray
+colorFrom: blue
+colorTo: indigo
 sdk: gradio
-sdk_version: 6.12.0
+sdk_version: "5.0"
 app_file: app.py
 pinned: false
 license: mit
-short_description: Compress natural language to structured AI instructions.
+short_description: Compress natural language to structured AI instructions
+tags:
+  - protocol
+  - compression
+  - ai-communication
+  - prompt-engineering
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# I-Lang: AI Communication Protocol
+
+Compress natural language into structured, machine-readable instructions using the I-Lang protocol.
+
+## What is I-Lang?
+
+I-Lang is a communication protocol for human-AI and AI-to-AI interaction. It uses 52 verbs, 28 modifiers, and 14 entities with pipe syntax to compress instructions by 40-65%.
+
+## Try it
+
+1. **Compress**: Paste any instruction or workflow description, set compression ratio, get I-Lang output
+2. **Expand**: Paste I-Lang notation, get human-readable explanation
+
+## Links
+
+- [Protocol Spec](https://github.com/ilang-ai/ilang-spec)
+- [Dictionary](https://github.com/ilang-ai/ilang-dict)
+- [Datasets](https://huggingface.co/i-Lang)
+- [Research Paper](https://doi.org/10.13140/RG.2.2.22821.97762)
+
+## Example
+
+**Input:**
+```
+Read the README from GitHub, translate it to Chinese, and save to cloud storage.
+```
+
+**I-Lang (60% compression):**
+```
+[READ:@GH|path=readme.md]=>[θ|lng=zh]=>[WRIT:@R2|path=readme_zh.md]
+```
+
+---
+I-Lang v2.0 | Palm Media Technology

app.py

@@ -0,0 +1,148 @@
+import gradio as gr
+import requests
+import json
+import tiktoken
+
+API_URL = "https://api.ilang.ai"
+
+def count_tokens(text):
+    """Estimate token count using cl100k_base."""
+    try:
+        enc = tiktoken.get_encoding("cl100k_base")
+        return len(enc.encode(text))
+    except Exception:
+        return len(text.split()) * 1.3  # fallback rough estimate
+
+def compress(text, ratio):
+    """Call api.ilang.ai to compress natural language to I-Lang."""
+    if not text.strip():
+        return "", "", ""
+
+    try:
+        resp = requests.post(
+            API_URL,
+            json={"input": text, "ratio": ratio / 100},
+            headers={"Content-Type": "application/json"},
+            timeout=30,
+        )
+        if resp.status_code == 200:
+            data = resp.json()
+            compressed = data.get("output", data.get("text", str(data)))
+        elif resp.status_code == 429:
+            return "Rate limited. Try again in a minute.", "", ""
+        else:
+            return f"API error {resp.status_code}", "", ""
+    except Exception as e:
+        return f"Connection error: {e}", "", ""
+
+    original_tokens = count_tokens(text)
+    compressed_tokens = count_tokens(compressed)
+    if original_tokens > 0:
+        actual_ratio = (1 - compressed_tokens / original_tokens) * 100
+        savings = f"{original_tokens} tokens -> {compressed_tokens} tokens ({actual_ratio:.0f}% saved)"
+    else:
+        savings = ""
+
+    return compressed, savings, f"Original: {len(text)} chars | Compressed: {len(compressed)} chars"
+
+def decompress(ilang_text):
+    """Call api.ilang.ai to expand I-Lang back to natural language."""
+    if not ilang_text.strip():
+        return ""
+
+    prompt = f"Expand this I-Lang notation back to clear, natural English:\n\n{ilang_text}"
+    try:
+        resp = requests.post(
+            API_URL,
+            json={"input": prompt, "ratio": 0},
+            headers={"Content-Type": "application/json"},
+            timeout=30,
+        )
+        if resp.status_code == 200:
+            data = resp.json()
+            return data.get("output", data.get("text", str(data)))
+        else:
+            return f"API error {resp.status_code}"
+    except Exception as e:
+        return f"Connection error: {e}"
+
+EXAMPLES = [
+    ["Read the README from GitHub, translate it to Chinese, and save to cloud storage.", 60],
+    ["Scrape Hacker News, filter AI-related posts, summarize top 5, format as markdown table, send to Telegram.", 70],
+    ["Check if the user's input contains sensitive content. If yes, reject with explanation. If no, process normally and log the result.", 50],
+]
+
+with gr.Blocks(
+    title="I-Lang Protocol",
+    theme=gr.themes.Base(),
+    css="""
+    .header { text-align: center; margin-bottom: 1rem; }
+    .stats { font-family: monospace; color: #666; }
+    """
+) as demo:
+
+    gr.Markdown("""
+    # I-Lang: AI Communication Protocol
+    **Compress natural language into structured, machine-readable instructions.**
+
+    52 verbs | 28 modifiers | 14 entities | Pipe syntax | 40-65% compression
+
+    [GitHub](https://github.com/ilang-ai) | [Spec](https://github.com/ilang-ai/ilang-spec) | [Dictionary](https://github.com/ilang-ai/ilang-dict) | [Paper](https://doi.org/10.13140/RG.2.2.22821.97762)
+    """)
+
+    with gr.Tab("Compress"):
+        with gr.Row():
+            with gr.Column():
+                input_text = gr.Textbox(
+                    label="Natural Language",
+                    placeholder="Describe a task, workflow, or instruction...",
+                    lines=6,
+                )
+                ratio_slider = gr.Slider(
+                    minimum=20, maximum=90, value=60, step=5,
+                    label="Target Compression (%)",
+                    info="Higher = denser output, less human-readable"
+                )
+                compress_btn = gr.Button("Compress to I-Lang", variant="primary")
+
+            with gr.Column():
+                output_text = gr.Textbox(label="I-Lang Output", lines=6, show_copy_button=True)
+                savings_text = gr.Textbox(label="Token Savings", interactive=False, elem_classes="stats")
+                chars_text = gr.Textbox(label="Character Count", interactive=False, elem_classes="stats")
+
+        compress_btn.click(
+            compress,
+            inputs=[input_text, ratio_slider],
+            outputs=[output_text, savings_text, chars_text],
+        )
+
+        gr.Examples(
+            examples=EXAMPLES,
+            inputs=[input_text, ratio_slider],
+        )
+
+    with gr.Tab("Expand"):
+        with gr.Row():
+            with gr.Column():
+                ilang_input = gr.Textbox(
+                    label="I-Lang Input",
+                    placeholder="Paste I-Lang notation here...",
+                    lines=6,
+                )
+                expand_btn = gr.Button("Expand to Natural Language", variant="primary")
+            with gr.Column():
+                expanded_output = gr.Textbox(label="Natural Language", lines=6, show_copy_button=True)
+
+        expand_btn.click(
+            decompress,
+            inputs=[ilang_input],
+            outputs=[expanded_output],
+        )
+
+    gr.Markdown("""
+    ---
+    I-Lang v2.0 | Created by AI x Human collaboration | Palm Media Technology
+    """)
+
+if __name__ == "__main__":
+    demo.launch()

requirements.txt

@@ -0,0 +1,3 @@
+gradio>=4.0
+requests
+tiktoken