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** 🤖🔄🤖
