{"id":50809996,"url":"https://github.com/openvoiceos/ovos-spec-tools","last_synced_at":"2026-06-27T04:01:05.262Z","repository":{"id":359618152,"uuid":"1246592900","full_name":"OpenVoiceOS/ovos-spec-tools","owner":"OpenVoiceOS","description":"Reference implementation of the OVOS formal specifications — sentence template expander, locale resource loader, dialog renderer, language matching, and a locale linter","archived":false,"fork":false,"pushed_at":"2026-06-25T16:42:55.000Z","size":284,"stargazers_count":0,"open_issues_count":15,"forks_count":0,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2026-06-25T18:21:17.167Z","etag":null,"topics":["i18n","intent-parser","linter","nlu","openvoiceos","ovos","python","voice-assistant"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenVoiceOS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["OpenVoiceOS"],"patreon":"openvoiceos","liberapay":"OpenVoiceOS-Foundation","custom":"https://paypal.me/openvoiceos"}},"created_at":"2026-05-22T10:53:04.000Z","updated_at":"2026-06-25T16:42:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/OpenVoiceOS/ovos-spec-tools","commit_stats":null,"previous_names":["openvoiceos/ovos-spec-tools"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/OpenVoiceOS/ovos-spec-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-spec-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-spec-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-spec-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-spec-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenVoiceOS","download_url":"https://codeload.github.com/OpenVoiceOS/ovos-spec-tools/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-spec-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34840899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["i18n","intent-parser","linter","nlu","openvoiceos","ovos","python","voice-assistant"],"created_at":"2026-06-13T04:01:31.127Z","updated_at":"2026-06-27T04:01:05.236Z","avatar_url":"https://github.com/OpenVoiceOS.png","language":"Python","funding_links":["https://github.com/sponsors/OpenVoiceOS","https://patreon.com/openvoiceos","https://liberapay.com/OpenVoiceOS-Foundation","https://paypal.me/openvoiceos"],"categories":[],"sub_categories":[],"readme":"# ovos-spec-tools\n\nReference implementation of the OVOS [formal\nspecifications](https://github.com/OpenVoiceOS/architecture) — the\nlow-level, dependency-light primitives those specifications describe.\n\nOVOS components reimplement template expansion, resource loading, and language\nmatching in several places, and the copies drift. This package is the single\nconformant implementation those components — and any third-party tool — can\ndepend on.\n\n## Status\n\n| Tool | Spec | Code |\n|------|------|-------|\n| Sentence template expander | OVOS-INTENT-1 v2 | `expansion.py` |\n| Locale resource loader | OVOS-INTENT-2 |  `resources.py`  |\n| Dialog renderer | OVOS-INTENT-2 §4.2 |  `dialog.py`  |\n| Prompt renderer | OVOS-INTENT-2 §4.4 |  `prompt.py`  |\n| Language-tag matching | OVOS-INTENT-2 §2.2 |  `language.py` |\n| Bus message envelope | OVOS-MSG-1 |  `message.py`  |\n| `ovos-spec-lint` locale linter | OVOS-INTENT-1 / -2 |  `lint.py`  |\n\n## Install\n\n```bash\npip install ovos-spec-tools            # core — no dependencies\npip install ovos-spec-tools[langcodes] # adds the smart language fallback\n```\n\nRequires Python 3.10+.\n\n## Quick taste\n\n```python\nfrom ovos_spec_tools import (expand, LocaleResources, render, render_prompt,\n                             closest_lang, Message)\n\nexpand(\"(turn|switch) [the] light\")          # all 4 sentences it denotes\nres = LocaleResources(\"my-skill/locale\")\nres.load_intent(\"play\", \"en-US\")             # a skill's intent samples\nrender(res.load_dialog(\"weather\", \"en-US\"),  # a spoken response\n       slots={\"temperature\": 21})\nrender_prompt(res.load_prompt(\"system\", \"en-US\"),  # a language-model prompt\n              slots={\"query\": \"what time is it\"})\nclosest_lang(\"en-AU\", [\"pt-BR\", \"en-US\"])    # 'en-US'\n\n# OVOS-MSG-1 envelope: a bus message and its 'send back to the asker' reply\nm = Message(\"ovos.intent.list\", {}, {\"source\": \"skill.id\"})\nres = m.response({\"intents\": [\"...\"]})       # 'ovos.intent.list.response'\nres.serialize()                              # single UTF-8 JSON object\n```\n\n```bash\novos-spec-lint my-skill/locale               # validate a locale folder\n```\n\n## Documentation\n\nA zero-to-hero guide lives in [`docs/`](docs/README.md):\n\n1. [Getting started](docs/getting-started.md) — install, and a first taste of\n   every tool.\n2. [Sentence templates](docs/templates.md) — the grammar: alternatives,\n   optionals, slots, vocabulary references, malformed forms.\n3. [Locale resources](docs/locale-resources.md) — the `locale/` folder, the\n   six file roles, loading across languages, override precedence.\n4. [Dialog](docs/dialog.md) — choosing and filling a spoken response, and\n   rendering language-model prompts.\n5. [Language matching](docs/language-matching.md) — tag standardization,\n   distance, and closest-match resolution.\n6. [Bus messages](docs/message.md) — the on-the-wire envelope, the\n   `forward` / `reply` / `response` derivations, and the session carrier.\n7. [Linting](docs/linting.md) — validating a locale folder, on the CLI or in CI.\n7. [API reference](docs/api-reference.md) — every public name, in brief.\n\nRunnable example scripts are in [`examples/`](examples/README.md).\n\n---\n\n## Credits\n\nDeveloped by [TigreGótico](https://tigregotico.pt) for\n[OpenVoiceOS](https://openvoiceos.org).\n\n[![NGI0 Commons Fund](./ngi.png)](https://nlnet.nl/project/OpenVoiceOS)\n\nThis project was funded through the [NGI0 Commons Fund](https://nlnet.nl/commonsfund),\na fund established by [NLnet](https://nlnet.nl) with financial support from the\nEuropean Commission's [Next Generation Internet](https://ngi.eu) programme, under\nthe aegis of [DG Communications Networks, Content and Technology](https://commission.europa.eu/about-european-commission/departments-and-executive-agencies/communications-networks-content-and-technology_en)\nunder grant agreement No [101135429](https://cordis.europa.eu/project/id/101135429).\n\n---\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvoiceos%2Fovos-spec-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenvoiceos%2Fovos-spec-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvoiceos%2Fovos-spec-tools/lists"}