{"id":43225846,"url":"https://github.com/johnsamuelwrites/multilingual","last_synced_at":"2026-05-23T12:03:00.662Z","repository":{"id":83107451,"uuid":"448663441","full_name":"johnsamuelwrites/multilingual","owner":"johnsamuelwrites","description":"Not yet another programming language. A multilingual one.","archived":false,"fork":false,"pushed_at":"2026-05-23T10:09:09.000Z","size":2386,"stargazers_count":10,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-23T10:26:03.448Z","etag":null,"topics":["developer","development","multilingual","multilingual-programming","programming","programming-language"],"latest_commit_sha":null,"homepage":"https://johnsamuel.info/multilingual/playground.html","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/johnsamuelwrites.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmaps/multilingual_1_0.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2022-01-16T20:19:37.000Z","updated_at":"2026-05-23T10:09:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"b2b13327-703b-45d3-9714-7c56c96edbad","html_url":"https://github.com/johnsamuelwrites/multilingual","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/johnsamuelwrites/multilingual","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnsamuelwrites%2Fmultilingual","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnsamuelwrites%2Fmultilingual/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnsamuelwrites%2Fmultilingual/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnsamuelwrites%2Fmultilingual/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johnsamuelwrites","download_url":"https://codeload.github.com/johnsamuelwrites/multilingual/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnsamuelwrites%2Fmultilingual/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33394672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["developer","development","multilingual","multilingual-programming","programming","programming-language"],"created_at":"2026-02-01T09:36:48.958Z","updated_at":"2026-05-23T12:03:00.656Z","avatar_url":"https://github.com/johnsamuelwrites.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# multilingual\nNot yet another programming language. A multilingual one.\n\n\u003e **One semantic core. Many human languages.**\n\u003e  \n\u003e Build software through human-language-first syntax with native support for AI,\n\u003e multimodal workflows, reactive interfaces, and portable execution.\n\n## Vision\n\n`multilingual` is becoming a programming language for the age of human\nlanguage, AI, multimodal computing, and living interfaces.\n\nIts purpose is bigger than keyword translation. The goal is to make it possible\nto express the same precise program semantics across human languages while also\nmaking modern software primitives feel native:\n\n- structured data and pattern matching\n- AI generation, extraction, planning, and tool use\n- multimodal input and output\n- reactive state and interfaces\n- portable execution across environments\n\nRead the language direction here:\n\n- Vision: [docs/vision.md](docs/vision.md)\n- Core 1.0: [docs/spec/core_1_0.md](docs/spec/core_1_0.md)\n- 1.0 roadmap: [docs/roadmaps/multilingual_1_0.md](docs/roadmaps/multilingual_1_0.md)\n\n## Strategic Direction\n\nThe project is moving toward a clearer identity:\n\n- one semantic programming model expressed through many human languages\n- first-class semantics for AI, retrieval, tools, and multimodal workflows\n- structured concurrency, observability, memory, and agent coordination\n- reactive and distributed programs that span browser, device, edge, and cloud\n- portable execution where semantics stay stable while backends adapt\n\nThe repository already contains early pieces of that future, but the current\nimplementation is still a transitional platform between the historical\nmultilingual compiler pipeline and the fuller Core 1.0 language model.\n\n## What Multilingual Is\n\n- a human-language-first programming language\n- a shared semantic model expressed through multiple language surfaces\n- an AI-native language platform, not just a syntax experiment\n- a research and implementation space for multilingual programming systems\n\n## Why Multilingual\n\n- **Human-language-first programming**: code should not force people to abandon\n  their language or mode of expression.\n- **Shared semantics**: different human-language surfaces should express the\n  same underlying program.\n- **AI-native direction**: models, tools, retrieval, and semantic workflows are\n  becoming first-class language concepts.\n- **Portable architecture**: one language should move across runtimes and\n  environments without losing meaning.\n\n### Pipeline Illustration\n\n![Multilingual pipeline with surface normalization](docs/assets/multilingual_pipeline_surface.svg)\n\n## Current Platform\n\nToday the repository already provides:\n\n- multilingual frontends driven by the USM keyword model\n- a shared parser, AST, and semantic-IR direction\n- semantic analysis plus Python and WAT/WASM code generation\n- Python execution support\n- WAT/WASM generation and backend selection\n- browser demos and DOM-oriented workflows\n\nThis is an active language platform in motion, not just a whitepaper.\n\n## Current Limitations\n\n- the current semantic core is still thinner than the long-term Core 1.0 model\n- some localized surfaces still feel less natural than they should\n- parts of the implementation still reflect the historical compiler pipeline\n  more than the future language experience\n- AI-native, multimodal, reactive, concurrent, and distributed constructs are\n  in mixed stages of design, prototyping, and rollout\n- documentation still needs ongoing migration from \"current compiler\" wording\n  toward \"future language platform\" wording\n\nDetails:\n\n- Word order and naturalness: [docs/word_order_and_naturalness.md](docs/word_order_and_naturalness.md)\n- Controlled language scope: [docs/cnl_scope.md](docs/cnl_scope.md)\n- Current compatibility matrix: [docs/compatibility_matrix.md](docs/compatibility_matrix.md)\n\n## Quick Start\n\nSource files now prefer the `.multi` extension. The legacy `.ml` extension\nremains fully supported for compatibility. Running the current implementation\nrequires Python 3.12 or newer.\n\n### Try The Playground\n\nYou can try `multilingual` directly in your browser:\n\n- Playground: https://johnsamuel.info/multilingual/playground.html\n\nThe playground lets you:\n\n- write code in supported human languages\n- run execution in Pyodide\n- inspect generated Python\n- inspect generated WAT/WASM output\n- inspect generated Wasmtime bridge code\n\n## Install\n\nPyPI package: https://pypi.org/project/multilingualprogramming/\n\nOption 1:\n\n```bash\npython3 -m venv .venv\nsource .venv/bin/activate\npython -m pip install --upgrade pip\npython -m pip install multilingualprogramming\n```\n\nOption 2:\n\n```bash\npipx install multilingualprogramming\n```\n\nFor local development from source:\n\n```bash\npip install -r requirements.txt\npip install .\n```\n\nOptional runtime extras:\n\n```bash\npip install \"multilingualprogramming[wasm]\"\npip install \"multilingualprogramming[ai]\"\npip install \"multilingualprogramming[all]\"\n```\n\n## Hello World\n\n```text\n# English\nprint(\"Hello world\")\n\n# French\nafficher(\"Bonjour le monde\")\n\n# Spanish\nimprimir(\"Hola mundo\")\n```\n\n## Use the REPL\n\n```bash\nmultilingual\nmultilingual repl\nmultilingual repl --lang fr\nmultilingual repl --show-python\nmultilingual repl --show-wat\nmultilingual repl --show-rust\n```\n\nREPL commands:\n\n- `:help` show commands\n- `:language \u003ccode\u003e` switch language\n- `:python` toggle generated Python display\n- `:wat` toggle generated WAT display\n- `:rust` toggle generated Wasmtime bridge display\n- `:reset` clear session state\n- `:kw [XX]` show language keywords\n- `:ops [XX]` show operators and symbols\n- `:q` exit\n\n## Run a Program\n\n```bash\nmultilingual hello_en.multi\nmultilingual run hello_en.multi\nmultilingual run hello_fr.multi --lang fr\nmultilingual run hello_en.multi --show-backend\n```\n\n## Cross-Language Module Imports\n\nYou can import `.multi` and `.ml` modules across language surfaces in one program.\n\n`module_fr.multi`:\n\n```text\nsoit valeur = 41\ndef incremente(x):\n    retour x + 1\n```\n\n`main_en.multi`:\n\n```text\nimport module_fr\nprint(module_fr.incremente(module_fr.valeur))\n```\n\nRun:\n\n```bash\nmultilingual run main_en.multi --lang en\n```\n\n## Roadmap\n\nNear-term priorities:\n\n- stabilize the Core 1.0 semantic model\n- strengthen the semantic IR and capability-aware analysis pipeline\n- ship more unmistakable language features such as `fn`, `var`, `enum`, `|\u003e`,\n  `par`, `spawn`, `memory`, and observability primitives\n- continue building AI-native, multimodal, reactive, and distributed features\n  on top of that core\n\nSee:\n\n- [docs/roadmaps/multilingual_1_0.md](docs/roadmaps/multilingual_1_0.md)\n\n## More Documentation\n\n- Usage examples: [USAGE.md](USAGE.md)\n- Language design overview: [docs/design.md](docs/design.md)\n- Frontend contracts: [docs/frontend_contracts.md](docs/frontend_contracts.md)\n- Core spec draft: [docs/spec/core_1_0.md](docs/spec/core_1_0.md)\n\n## Architect and Creator\n- John Samuel\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnsamuelwrites%2Fmultilingual","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnsamuelwrites%2Fmultilingual","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnsamuelwrites%2Fmultilingual/lists"}