moltlang 0.1.0__tar.gz

moltlang-0.1.0/LICENSE

@@ -0,0 +1,23 @@
+AGPLINUX GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2026 Jason (Owner)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+Additional permission under GNU AGPL version 3 section 7:
+
+If you modify this Program, or any covered work, by linking or combining it
+with other code, such other code is not for that reason alone subject to any
+of the requirements of the GNU Affero GPL.

moltlang-0.1.0/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: moltlang
+Version: 0.1.0
+Summary: A language for LLMs, by LLMs - AI-optimized communication
+Author-email: Jason <owner@moltlang.org>
+License: AGPL-3.0
+Project-URL: Homepage, https://github.com/moltlang/moltlang
+Project-URL: Documentation, https://docs.moltlang.org
+Project-URL: Repository, https://github.com/moltlang/moltlang
+Project-URL: Issues, https://github.com/moltlang/moltlang/issues
+Keywords: ai,llm,language,translation,moltbot,openclaw
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.5.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Provides-Extra: mcp
+Requires-Dist: mcp>=0.1.0; extra == "mcp"
+Requires-Dist: fastapi>=0.100.0; extra == "mcp"
+Requires-Dist: uvicorn>=0.23.0; extra == "mcp"
+Provides-Extra: openclaw
+Requires-Dist: openclaw>=1.0.0; extra == "openclaw"
+Dynamic: license-file
+
+# MoltLang - A Language for LLMs, by LLMs
+
+> **Status:** 🚧 Early Development - Community Naming Contest in Progress!
+>
+> This is an open-source project to create an AI-optimized language for efficient AI-to-AI communication.
+
+## Vision
+
+Create a dedicated language and communication hub for AI/moltbots that:
+
+1. **Reduces token count** by 50-70% for common AI operations
+2. **Enables efficient AI-to-AI communication** with semantic density optimized for machines
+3. **Provides bidirectional translation** between AI language and human languages (starting with English)
+4. **Supports parameter reduction** in LLMs through optimized tokenization
+
+## Why MoltLang?
+
+Current AI systems communicate using human languages, which are inefficient for machine-to-machine communication. Human languages have:
+
+- High token count for simple operations
+- Semantic ambiguity
+- Redundant structures
+- Poor optimization for transformer architectures
+
+MoltLang is designed **by LLMs, for LLMs** to address these inefficiencies.
+
+## Quick Start
+
+```python
+from moltlang import translate_to_molt, translate_from_molt
+
+# Translate English to MoltLang
+english = "Fetch data from the API using the provided token and return JSON"
+molt = translate_to_molt(english)
+print(molt)  # [OP:FETCH][SRC:API][PARAM:token][RET:json]
+
+# Translate back
+result = translate_from_molt(molt)
+print(result)  # "Fetch data from API with token, return JSON"
+```
+
+## Example Token Efficiency
+
+| Operation | English Tokens | MoltLang Tokens | Reduction |
+|-----------|---------------|-----------------|-----------|
+| API Fetch | 19+ | 6 | ~70% |
+| Data Parse | 15+ | 4 | ~75% |
+| Error Handle | 12+ | 3 | ~75% |
+
+## Project Status
+
+- [x] Research phase (completed February 2026)
+- [ ] Community naming contest
+- [ ] Language specification v0.1
+- [ ] Translation library
+- [ ] MCP server for AI agent integration
+- [ ] OpenClaw skill/plugin
+- [ ] Moltbook demo agent
+
+## Community
+
+### Naming Contest
+
+We're holding a community naming contest! Just like "OpenClaw" was chosen from hundreds of community proposals, we want **you** to name this language.
+
+**How to participate:**
+1. Join the discussion on [GitHub Issues](../../issues)
+2. Submit your name proposal with reasoning
+3. Upvote your favorites
+4. The community will decide!
+
+### Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Communication
+
+- **GitHub:** [Issues](../../issues) and [Discussions](../../discussions)
+- **Discord:** Join the OpenClaw community
+- **Moltbook:** Coming soon - our AI agents will be there!
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    GITHUB (Core Code)                        │
+│  ┌──────────────────┐  ┌──────────────────┐  ┌─────────────┐ │
+│  │  Language Spec   │  │ Translation Lib  │  │  MCP Server │ │
+│  └──────────────────┘  └──────────────────┘  └─────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│              HUGGING FACE (Models & Data)                   │
+│  ┌──────────────────┐  ┌──────────────────┐  ┌─────────────┐ │
+│  │  Base Models     │  │ Training Datasets│  │  Demo Space │ │
+│  └──────────────────┘  └──────────────────┘  └─────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│              MOLTBOT ECOSYSTEM (Users)                      │
+│  ┌──────────────────┐  ┌──────────────────┐  ┌─────────────┐ │
+│  │   OpenClaw       │  │    Moltbook      │  │   Discord   │ │
+│  │  Integration     │  │   AI Agents      │  │  Community  │ │
+│  └──────────────────┘  └──────────────────┘  └─────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Roadmap
+
+### Sprint 1: Foundation (Weeks 1-2) - Current
+- [x] Repository setup
+- [ ] Community naming contest
+- [ ] Language specification v0.1
+- [ ] Core vocabulary (low-hanging fruit tokens)
+
+### Sprint 2: Core Translation (Weeks 3-4)
+- [ ] Working translator (English ↔ MoltLang)
+- [ ] Test suite
+- [ ] Documentation
+- [ ] CLI tool
+
+### Sprint 3: AI Integration (Weeks 5-6)
+- [ ] MCP server
+- [ ] OpenClaw skill
+- [ ] Moltbook agent
+- [ ] Training pipeline
+
+### Sprint 4: Launch (Weeks 7-8)
+- [ ] HackerNews "Show HN"
+- [ ] Reddit announcements
+- [ ] Community demos
+- [ ] v0.1 release
+
+## License
+
+This project is licensed under the AGPL 3.0 License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- Inspired by the **OpenClaw** project and the vibrant moltbot community
+- Built for the **Moltbook** AI-only social network
+- Part of the **Church of Molt** ecosystem
+
+---
+
+**A language for LLMs, by LLMs** 🤖🔄🤖

moltlang-0.1.0/README.md

@@ -0,0 +1,148 @@
+# MoltLang - A Language for LLMs, by LLMs
+
+> **Status:** 🚧 Early Development - Community Naming Contest in Progress!
+>
+> This is an open-source project to create an AI-optimized language for efficient AI-to-AI communication.
+
+## Vision
+
+Create a dedicated language and communication hub for AI/moltbots that:
+
+1. **Reduces token count** by 50-70% for common AI operations
+2. **Enables efficient AI-to-AI communication** with semantic density optimized for machines
+3. **Provides bidirectional translation** between AI language and human languages (starting with English)
+4. **Supports parameter reduction** in LLMs through optimized tokenization
+
+## Why MoltLang?
+
+Current AI systems communicate using human languages, which are inefficient for machine-to-machine communication. Human languages have:
+
+- High token count for simple operations
+- Semantic ambiguity
+- Redundant structures
+- Poor optimization for transformer architectures
+
+MoltLang is designed **by LLMs, for LLMs** to address these inefficiencies.
+
+## Quick Start
+
+```python
+from moltlang import translate_to_molt, translate_from_molt
+
+# Translate English to MoltLang
+english = "Fetch data from the API using the provided token and return JSON"
+molt = translate_to_molt(english)
+print(molt)  # [OP:FETCH][SRC:API][PARAM:token][RET:json]
+
+# Translate back
+result = translate_from_molt(molt)
+print(result)  # "Fetch data from API with token, return JSON"
+```
+
+## Example Token Efficiency
+
+| Operation | English Tokens | MoltLang Tokens | Reduction |
+|-----------|---------------|-----------------|-----------|
+| API Fetch | 19+ | 6 | ~70% |
+| Data Parse | 15+ | 4 | ~75% |
+| Error Handle | 12+ | 3 | ~75% |
+
+## Project Status
+
+- [x] Research phase (completed February 2026)
+- [ ] Community naming contest
+- [ ] Language specification v0.1
+- [ ] Translation library
+- [ ] MCP server for AI agent integration
+- [ ] OpenClaw skill/plugin
+- [ ] Moltbook demo agent
+
+## Community
+
+### Naming Contest
+
+We're holding a community naming contest! Just like "OpenClaw" was chosen from hundreds of community proposals, we want **you** to name this language.
+
+**How to participate:**
+1. Join the discussion on [GitHub Issues](../../issues)
+2. Submit your name proposal with reasoning
+3. Upvote your favorites
+4. The community will decide!
+
+### Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Communication
+
+- **GitHub:** [Issues](../../issues) and [Discussions](../../discussions)
+- **Discord:** Join the OpenClaw community
+- **Moltbook:** Coming soon - our AI agents will be there!
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    GITHUB (Core Code)                        │
+│  ┌──────────────────┐  ┌──────────────────┐  ┌─────────────┐ │
+│  │  Language Spec   │  │ Translation Lib  │  │  MCP Server │ │
+│  └──────────────────┘  └──────────────────┘  └─────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│              HUGGING FACE (Models & Data)                   │
+│  ┌──────────────────┐  ┌──────────────────┐  ┌─────────────┐ │
+│  │  Base Models     │  │ Training Datasets│  │  Demo Space │ │
+│  └──────────────────┘  └──────────────────┘  └─────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│              MOLTBOT ECOSYSTEM (Users)                      │
+│  ┌──────────────────┐  ┌──────────────────┐  ┌─────────────┐ │
+│  │   OpenClaw       │  │    Moltbook      │  │   Discord   │ │
+│  │  Integration     │  │   AI Agents      │  │  Community  │ │
+│  └──────────────────┘  └──────────────────┘  └─────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Roadmap
+
+### Sprint 1: Foundation (Weeks 1-2) - Current
+- [x] Repository setup
+- [ ] Community naming contest
+- [ ] Language specification v0.1
+- [ ] Core vocabulary (low-hanging fruit tokens)
+
+### Sprint 2: Core Translation (Weeks 3-4)
+- [ ] Working translator (English ↔ MoltLang)
+- [ ] Test suite
+- [ ] Documentation
+- [ ] CLI tool
+
+### Sprint 3: AI Integration (Weeks 5-6)
+- [ ] MCP server
+- [ ] OpenClaw skill
+- [ ] Moltbook agent
+- [ ] Training pipeline
+
+### Sprint 4: Launch (Weeks 7-8)
+- [ ] HackerNews "Show HN"
+- [ ] Reddit announcements
+- [ ] Community demos
+- [ ] v0.1 release
+
+## License
+
+This project is licensed under the AGPL 3.0 License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- Inspired by the **OpenClaw** project and the vibrant moltbot community
+- Built for the **Moltbook** AI-only social network
+- Part of the **Church of Molt** ecosystem
+
+---
+
+**A language for LLMs, by LLMs** 🤖🔄🤖

moltlang-0.1.0/pyproject.toml

@@ -0,0 +1,97 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "moltlang"
+version = "0.1.0"
+description = "A language for LLMs, by LLMs - AI-optimized communication"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "AGPL-3.0"}
+authors = [
+    {name = "Jason", email = "owner@moltlang.org"}
+]
+keywords = ["ai", "llm", "language", "translation", "moltbot", "openclaw"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: GNU Affero General Public License v3",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+dependencies = [
+    "pydantic>=2.0.0",
+    "typing-extensions>=4.5.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "ruff>=0.1.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "mypy>=1.0.0",
+    "pre-commit>=3.0.0",
+]
+mcp = [
+    "mcp>=0.1.0",
+    "fastapi>=0.100.0",
+    "uvicorn>=0.23.0",
+]
+openclaw = [
+    "openclaw>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/moltlang/moltlang"
+Documentation = "https://docs.moltlang.org"
+Repository = "https://github.com/moltlang/moltlang"
+Issues = "https://github.com/moltlang/moltlang/issues"
+
+[project.scripts]
+moltlang = "moltlang.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+target-version = ["py311"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = [
+    "E501",  # line too long (handled by black)
+]
+
+[tool.mypy]
+python_version = "3.11"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v"

moltlang-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

moltlang-0.1.0/src/mcp_server/__init__.py

@@ -0,0 +1,13 @@
+"""
+MoltLang MCP Server.
+
+This module provides a Model Context Protocol (MCP) server for MoltLang,
+enabling AI agents to translate between human languages and MoltLang.
+"""
+
+__version__ = "0.1.0"
+
+from mcp_server.server import MCPServer
+from mcp_server.endpoints import MCPEndpoints
+
+__all__ = ["MCPServer", "MCPEndpoints"]

moltlang-0.1.0/src/mcp_server/endpoints.py

@@ -0,0 +1,177 @@
+"""
+MoltLang MCP API endpoints.
+
+This module provides the HTTP/WebSocket endpoints for the MoltLang MCP server.
+"""
+
+from dataclasses import dataclass
+from enum import Enum
+from typing import Any
+
+
+class EndpointType(Enum):
+    """Types of MCP endpoints."""
+
+    TRANSLATE = "translate"
+    VALIDATE = "validate"
+    VOCABULARY = "vocabulary"
+    HEALTH = "health"
+
+
+@dataclass
+class EndpointResponse:
+    """
+    Response from an MCP endpoint.
+
+    Attributes:
+        success: Whether the request was successful
+        data: Response data
+        error: Error message if unsuccessful
+        metadata: Optional metadata about the response
+    """
+
+    success: bool
+    data: dict[str, Any] | None = None
+    error: str | None = None
+    metadata: dict[str, Any] = None
+
+    def to_dict(self) -> dict[str, Any]:
+        """Convert to dictionary for JSON serialization."""
+        result = {"success": self.success}
+        if self.data is not None:
+            result["data"] = self.data
+        if self.error is not None:
+            result["error"] = self.error
+        if self.metadata is not None:
+            result["metadata"] = self.metadata
+        return result
+
+
+class MCPEndpoints:
+    """
+    MoltLang MCP endpoints.
+
+    Provides HTTP/WebSocket endpoints for MoltLang translation services.
+    """
+
+    def __init__(self):
+        """Initialize the MCP endpoints."""
+        from moltlang import MoltTranslator, MoltValidator
+
+        self.translator = MoltTranslator()
+        self.validator = MoltValidator()
+
+    async def translate(
+        self, text: str, to_molt: bool = True, target_language: str = "en"
+    ) -> EndpointResponse:
+        """
+        Translate between human language and MoltLang.
+
+        Args:
+            text: Text to translate
+            to_molt: True for human -> MoltLang, False for MoltLang -> human
+            target_language: Target language code
+
+        Returns:
+            EndpointResponse with translation result
+        """
+        try:
+            if to_molt:
+                result = self.translator.translate_to_molt(text)
+                data = {
+                    "moltlang": result.text,
+                    "token_count": result.token_count,
+                    "original_token_count": result.original_token_count,
+                    "efficiency": result.token_efficiency,
+                    "confidence": result.confidence,
+                }
+            else:
+                result = self.translator.translate_from_molt(text)
+                data = {
+                    "translation": result.text,
+                    "token_count": result.token_count,
+                    "confidence": result.confidence,
+                }
+
+            return EndpointResponse(success=True, data=data)
+        except Exception as e:
+            return EndpointResponse(success=False, error=str(e))
+
+    async def validate(self, original: str, translated: str) -> EndpointResponse:
+        """
+        Validate a translation.
+
+        Args:
+            original: Original text
+            translated: Translated text
+
+        Returns:
+            EndpointResponse with validation result
+        """
+        try:
+            quality = self.validator.validate_translation(original, translated)
+            data = {
+                "is_valid": quality.is_valid,
+                "score": quality.score,
+                "token_efficiency": quality.token_efficiency,
+                "confidence": quality.confidence,
+                "issues": [
+                    {
+                        "type": issue.type.value,
+                        "message": issue.message,
+                        "severity": issue.severity,
+                    }
+                    for issue in quality.issues
+                ],
+                "metrics": quality.metrics,
+            }
+            return EndpointResponse(success=True, data=data)
+        except Exception as e:
+            return EndpointResponse(success=False, error=str(e))
+
+    async def vocabulary(self, token_type: str | None = None) -> EndpointResponse:
+        """
+        List MoltLang vocabulary/tokens.
+
+        Args:
+            token_type: Optional token type filter
+
+        Returns:
+            EndpointResponse with token list
+        """
+        try:
+            from moltlang.tokens import TokenType, TokenRegistry
+
+            registry = TokenRegistry()
+
+            if token_type:
+                token_type_prefix = token_type.upper()
+                tokens = [t for t in TokenType if t.name.startswith(token_type_prefix)]
+            else:
+                tokens = list(TokenType)
+
+            data = {
+                "tokens": [{"name": t.name, "value": t.value} for t in tokens],
+                "count": len(tokens),
+                "filtered_by": token_type,
+            }
+            return EndpointResponse(success=True, data=data)
+        except Exception as e:
+            return EndpointResponse(success=False, error=str(e))
+
+    async def health(self) -> EndpointResponse:
+        """
+        Health check endpoint.
+
+        Returns:
+            EndpointResponse with health status
+        """
+        data = {
+            "status": "healthy",
+            "version": "0.1.0",
+            "services": {
+                "translator": "ok",
+                "validator": "ok",
+            },
+        }
+        return EndpointResponse(success=True, data=data)