{"id":50584901,"url":"https://github.com/thymianofficial/thymian","last_synced_at":"2026-06-05T05:24:50.971Z","repository":{"id":348777343,"uuid":"916676879","full_name":"thymianofficial/thymian","owner":"thymianofficial","description":"Thymian is a language-agnostic, open-source HTTP conformance and API governance tool. It validates your APIs against RFC standards and your OpenAPI specification — statically, against live endpoints, and in recorded production traffic. Fully extensible with plugins and shareable custom rules.","archived":false,"fork":false,"pushed_at":"2026-06-04T06:57:25.000Z","size":7028,"stargazers_count":27,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-04T08:22:34.900Z","etag":null,"topics":["ai","ai-agents","api","conformance","http","rest"],"latest_commit_sha":null,"homepage":"https://thymian.dev","language":"TypeScript","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/thymianofficial.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-01-14T15:05:58.000Z","updated_at":"2026-06-04T06:57:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/thymianofficial/thymian","commit_stats":null,"previous_names":["thymianofficial/thymian"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/thymianofficial/thymian","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thymianofficial%2Fthymian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thymianofficial%2Fthymian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thymianofficial%2Fthymian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thymianofficial%2Fthymian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thymianofficial","download_url":"https://codeload.github.com/thymianofficial/thymian/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thymianofficial%2Fthymian/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33932037,"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-05T02:00:06.157Z","response_time":120,"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":["ai","ai-agents","api","conformance","http","rest"],"created_at":"2026-06-05T05:24:49.858Z","updated_at":"2026-06-05T05:24:50.964Z","avatar_url":"https://github.com/thymianofficial.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./astro-docs/src/assets/logo.svg\" alt=\"Thymian Logo\" width=\"200\"/\u003e\n\n# Thymian\n\n**Add resilience and HTTP conformance to your API development workflow**\n\n[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL%203.0-green.svg)](./LICENSE)\n[![CI](https://github.com/thymianofficial/thymian/actions/workflows/ci.yaml/badge.svg)](https://github.com/thymianofficial/thymian/actions/workflows/ci.yaml)\n[![Documentation](https://img.shields.io/badge/docs-thymian.dev-green.svg)](https://thymian.dev)\n[![Discord](https://img.shields.io/discord/1440702693768429791?logo=discord\u0026label=Discord\u0026color=5865F2)](https://discord.gg/TRSwCxbz9f)\n[![Reddit](https://img.shields.io/badge/Reddit-ThymianOfficial-FF4500?logo=reddit)](https://www.reddit.com/r/ThymianOfficial/)\n[![Twitter](https://img.shields.io/badge/Twitter-@thymiandev-1DA1F2?logo=x)](https://x.com/thymiandev)\n\n\u003c/div\u003e\n\nThymian is a language-agnostic, open-source **HTTP conformance and API governance tool**. It validates your APIs against RFC standards and your OpenAPI specification out of the box, statically, against live endpoints, and in recorded production traffic. Fully extensible with plugins and shareable custom rules that you write once and run everywhere.\n\n## Key Capabilities\n\n- **Standards-First** — Validates against RFC 9110 and related HTTP specifications\n- **Write Once, Validate Everywhere** — A single rule definition works across `thymian lint`, `thymian test`, and `thymian analyze`\n- **Multi-Layer Governance** — Validates HTTP infrastructure, protocol compliance, technical implementation, and organizational guidelines\n- **Educational Reporting** — Violations explain the RFC semantics and real-world consequences, not just pass/fail\n- **Production-Aware** — Monitors how proxies, CDNs, and load balancers affect HTTP semantics in real deployments\n- **Language-Agnostic \u0026 Extensible** — Works with any tech stack; custom rules distributable as npm packages, remote plugins via WebSocket\n\n## 🚀 Quick Installation\n\n### Installation\n\nYou won't need to install Thymian locally, we will just use `npx` for this.\n\nCheck if you can run Thymian by running the following command:\n\n```bash\nnpx thymian --version\n```\n\n### First Run Without a Config\n\nNow navigate to your project's root directory and run Thymian directly against your API description:\n\n```bash\nnpx thymian lint --spec openapi:openapi.yaml\n```\n\nThis is the fastest way to reach a first conformance result without any prior setup.\n\n### Generate a Reusable Config\n\nIf you want to save that setup for future runs, generate a config file:\n\n```bash\nnpx thymian generate config\n```\n\nThis command detects your OpenAPI specification file and creates a `thymian.config.yaml` you can reuse with `npx thymian lint`.\n\n## 📚 Documentation\n\n- **[Getting Started](https://thymian.dev/introduction/getting-started)** - Set up Thymian in minutes\n- **[Documentation](https://thymian.dev)** - Comprehensive guides and API reference\n- **[CLI Reference](https://thymian.dev/references/cli)** - Complete CLI command documentation\n- **[HTTP Rules](https://thymian.dev/guides/http-rules/how-to-use-rules)** - Learn about HTTP conformance validation\n\n## 🏢 Enterprise Support\n\nGet professional consulting and dedicated support from the creators of Thymian. We offer:\n\n- API design and governance strategies\n- HTTP standards compliance auditing\n- Custom plugin development\n- Custom rule development\n- Team training and workshops\n\n**[Learn more about Enterprise Support](https://thymian.dev/enterprise)** | **Email: [support@thymian.dev](mailto:support@thymian.dev)**\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Shipped with 🌱 by [qupaya](https://qupaya.com)**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthymianofficial%2Fthymian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthymianofficial%2Fthymian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthymianofficial%2Fthymian/lists"}