{"id":36584663,"url":"https://github.com/hexmostech/lama2","last_synced_at":"2026-01-12T08:02:05.460Z","repository":{"id":63138317,"uuid":"565032269","full_name":"HexmosTech/Lama2","owner":"HexmosTech","description":"Free, Lightweight \u0026 Collaborative API Client","archived":false,"fork":false,"pushed_at":"2025-04-18T14:45:06.000Z","size":130572,"stargazers_count":118,"open_issues_count":22,"forks_count":6,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-19T04:15:48.688Z","etag":null,"topics":["api","api-client","api-design","api-rest","dsl","http","insomnia","language","postman-collection"],"latest_commit_sha":null,"homepage":"https://hexmos.com/lama2/index.html","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HexmosTech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-11-12T05:45:42.000Z","updated_at":"2025-04-18T14:45:11.000Z","dependencies_parsed_at":"2023-10-14T17:11:28.058Z","dependency_job_id":"a38f8d6a-05f0-4508-88d8-825430389d82","html_url":"https://github.com/HexmosTech/Lama2","commit_stats":{"total_commits":411,"total_committers":9,"mean_commits":"45.666666666666664","dds":0.318734793187348,"last_synced_commit":"b98fd6f256982fa7590ed0cd98bada464668ad0c"},"previous_names":[],"tags_count":58,"template":false,"template_full_name":null,"purl":"pkg:github/HexmosTech/Lama2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HexmosTech%2FLama2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HexmosTech%2FLama2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HexmosTech%2FLama2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HexmosTech%2FLama2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HexmosTech","download_url":"https://codeload.github.com/HexmosTech/Lama2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HexmosTech%2FLama2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28336972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["api","api-client","api-design","api-rest","dsl","http","insomnia","language","postman-collection"],"created_at":"2026-01-12T08:01:08.124Z","updated_at":"2026-01-12T08:02:05.437Z","avatar_url":"https://github.com/HexmosTech.png","language":"JavaScript","readme":"# `Lama2`: Free, Lightweight \u0026 Collaborative API Client\n\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://hexmos.com/lama2/banner.png\" width=\"80%\" /\u003e\n\n![Build](https://github.com/HexmosTech/Lama2/actions/workflows/release.yml/badge.svg)\n![Test](https://github.com/HexmosTech/Lama2/actions/workflows/testapp.yml/badge.svg)\n[![Go Report Card](https://goreportcard.com/badge/github.com/HexmosTech/lama2)](https://goreportcard.com/report/github.com/HexmosTech/lama2)\n\n\u003ca href=\"https://www.producthunt.com/posts/hexmos-lama2?utm_source=badge-featured\u0026utm_medium=badge\u0026utm_souce=badge-hexmos\u0026#0045;lama2\" target=\"_blank\"\u003e\u003cimg src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=370586\u0026theme=light\" alt=\"Hexmos\u0026#0032;Lama2 - Plain\u0026#0045;Text\u0026#0032;Powered\u0026#0032;REST\u0026#0032;API\u0026#0032;Client\u0026#0032;for\u0026#0032;Teams | Product Hunt\" style=\"width: 250px; height: 54px;\" width=\"250\" height=\"54\" /\u003e\u003c/a\u003e\n\n*Quick Links: [Installation](#installationupdate) | [Demo](#terminal-demo-a-post-request) | [Full Documentation](https://hexmos.com/lama2)*\n\u003c/div\u003e\n\n\u003e **Note**\n\u003e The frontend part of the Lama2 project lives in [Lama2Code](https://github.com/HexmosTech/Lama2Code). The\n\u003e extension tends to be updated along with the Lama2 core in this repo.\n\n## The Problem\n\nMost engineering teams have trouble collaborating on APIs or end up paying too much for Postman/Insomnia. Our 100% FOSS product *Lama2* helps your team collaborate on APIs for free based on git, so that you can save money and avoid friction.\n\n## About\n\n*Lama2* is a Plain-Text powered REST API client \u0026 manager built for serious engineering teams.\n*Lama2* specifies the [`.l2` syntax](https://hexmos.com/lama2/tutorials/examples.html) for describing APIs, and implements a [CLI](https://hexmos.com/lama2/tutorials/installation.html) to execute `.l2` files. Engineers [collaborate](https://hexmos.com/lama2/tutorials/collaboration.html) on `.l2` files using version control. *Lama2* [integrates](https://hexmos.com/lama2/tutorials/editor.html) nicely with\nIDEs and text-editors as well. Think of *Lama2* as [**Markdown for APIs.**](https://hexmos.com/lama2/reference/philosophy.html)\n\n## Benefits \n\n1. **Plain-Text files:** Store APIs in the Plain-Text `.l2` API files. [Simple](https://hexmos.com/lama2/explanation/l2format.html) and [human-friendly](https://hexmos.com/lama2/explanation/syntax.html) syntax. Learn [basics](https://hexmos.com/lama2/tutorials/examples.html) within  minutes!\n1. **Simple CLI:** Launch the [CLI](https://hexmos.com/lama2/tutorials/installation.html) tool `l2` on API files to make REST API requests.\n1. **Editor support:** Invoke *Lama2* from your [favorite text editor](https://hexmos.com/lama2/tutorials/installation.html#from-vs-code) or IDE. Helpful documentation and tool support to [build editor extensions](https://hexmos.com/lama2/tutorials/editor.html) included.\n1. **Longevity \u0026 track-ability:** Commit `.l2` files to `git` or other version control for long life \u0026 change tracking.\n1. **Collaboration:** Share [API repo](https://hexmos.com/lama2/tutorials/collaboration.html) with teammates and colleagues to collaborate\n1. **Code generation:** [Convert](https://hexmos.com/lama2/tutorials/codegen.html) `l2` API definitions into your preferred language/library, be it Python, Javascript, Java or many other options.\n1. **Powerful chaining:** Chain multiple `l2` requests through embedded [Javascript blocks](https://hexmos.com/lama2/tutorials/examples.html#chain-requests-using-javascript)\n1. **Documentation:** [Explore](https://hexmos.com/lama2/index.html) examples, how-tos, explanations, references, FAQ/RAQs, and diagrams. Documentation is a priority, so that you never have to get lost.\n1. **Extensibility:** `.l2` syntax is implemented as a *recursive descent parser*, based on a [formal grammar](https://hexmos.com/lama2/reference/grammar.html). [Dig into details](https://hexmos.com/lama2/reference/parser.html) and [implement](https://github.com/HexmosTech/Lama2/tree/main/parser) new syntax (ex: to support `websockets`)\n\n\u003e :bulb: **Coming from Postman?** Let *Lama2* help you [convert](https://hexmos.com/lama2/tutorials/postman.html) Postman\ndata dumps into a  nice  Plain-Text Lama2 repo.\n\n## Terminal Demo: A POST request\n\n![](https://hexmos.com/lama2/demo.gif)\n\n## VSCode Demo: The same POST request\n\n![](https://hexmos.com/lama2/demo2.gif)\n\n## Installation/Update\n\nFor **Linux/MacOS** systems, run the following command to either install or update *Lama2*:\n\n```\ncurl -s https://hexmos.com/lama2/install.sh | bash -s\n```\n\nFor **Windows** systems, run the following command on powershell as an **Administrator** to either install or update *Lama2*: \n\n```\nchoco install lama2 --version=1.0.0 --force -y\n```\n\nLearn more about other installation methods from [our docs](https://hexmos.com/lama2/tutorials/installation.html).\n\n### (Optional) Import your collections from Postman\n\nFollow [guide](https://hexmos.com/lama2/tutorials/postman.html)\n to import your existing Postman collections into a Plain-Text\n Lama2 repository.\n \n### Self update\n\nAn easier way to update the binary for **Linux/MacOS** to latest release is through:\n\n```\nl2 -u\n```\n\n\n### VSCode Extension\n\nFind *Lama2 for VSCode* at the [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=hexmos.Lama2). The extension requires the *l2* command available (usually at `/usr/local/bin/l2`).\n\n## Design Philosophy\n\nLama2 takes inspiration from Markdown. Think of our approach as Markdown for APIs.\n\nIn particular, we strive to:\n\n1. Delegate subtasks to mature and preferably open tools:\n    1. API Collaboration - git\n    1. API Organization - OS file system + IDEs\n    1. API Editing - VSCode/IDEs\n    1. API Requests - HTTPie ([httpie-go](https://github.com/nojima/httpie-go), to be specific)\n    1. Request Chaining - Embedded Javascript\n1. Start a language formalization effort from the beginning (learning from Markdown history)\n1. Keep language syntax simple\n1. Invest into good documentation; however, ensure users can perform competently without referencing documentation as much as possible.\n1. Strive to keep components decoupled\n\n\n## Community and Support\n\n1. [Full documentation @hexmos.com/lama2](https://hexmos.com/lama2/)\n1. Report issues and propose improvements at [Github issues](https://github.com/HexmosTech/Lama2/issues)\n1. Discuss with the community at [Discord](https://discord.gg/zTmxXA6F) and [Github Discussions](https://github.com/HexmosTech/Lama2/discussions)\n\n\n## Acknowledgements\n\n1. The excellent VSCode ecosystem helping us develop our [VSCode extension](https://github.com/HexmosTech/Lama2Code)\n1. httpie-go: A golang version of httpie which we have forked and integrated with Lama2. [Source](https://github.com/HexmosTech/httpie-go)\n1. httpsnippet: A HAR Request to multi-language converter; we use a custom fork of [httpsnippet](https://github.com/HexmosTech/httpsnippet) for code generation from l2 files.\n1. goja: A pure golang based JS interpreter with great, correct implementation of ECMA5. We use [goja](https://github.com/dop251/goja) for JS processor blocks in multi-stage API files.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhexmostech%2Flama2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhexmostech%2Flama2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhexmostech%2Flama2/lists"}