{"id":13591735,"url":"https://github.com/raystack/stencil","last_synced_at":"2025-12-12T01:16:57.548Z","repository":{"id":38316464,"uuid":"170960159","full_name":"raystack/stencil","owner":"raystack","description":"Stencil is a schema registry that provides schema management and validation dynamically, efficiently, and reliably to ensure data compatibility across applications.","archived":false,"fork":false,"pushed_at":"2024-06-05T20:19:08.000Z","size":4891,"stargazers_count":222,"open_issues_count":20,"forks_count":41,"subscribers_count":30,"default_branch":"main","last_synced_at":"2024-11-20T20:44:33.682Z","etag":null,"topics":["cli","clojure","clojure-library","dataops","descriptor","golang","javascript","javascript-library","js","protobuf","protocol-buffers","protocol-buffers-library","protocol-buffers-parsing","schema-registry","schema-validation"],"latest_commit_sha":null,"homepage":"https://raystack.github.io/stencil/","language":"Go","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/raystack.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}},"created_at":"2019-02-16T03:55:13.000Z","updated_at":"2024-10-29T04:22:37.000Z","dependencies_parsed_at":"2024-06-05T21:49:06.166Z","dependency_job_id":"629422ec-751e-4ff7-9ec2-474123315e49","html_url":"https://github.com/raystack/stencil","commit_stats":{"total_commits":290,"total_committers":29,"mean_commits":10.0,"dds":0.5413793103448277,"last_synced_commit":"2213f4b9120a8f8072d60f01f2af4e1e6f20d758"},"previous_names":["raystack/stencil","gojekfarm/stencil","odpf/stencil"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raystack%2Fstencil","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raystack%2Fstencil/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raystack%2Fstencil/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raystack%2Fstencil/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raystack","download_url":"https://codeload.github.com/raystack/stencil/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247393569,"owners_count":20931812,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cli","clojure","clojure-library","dataops","descriptor","golang","javascript","javascript-library","js","protobuf","protocol-buffers","protocol-buffers-library","protocol-buffers-parsing","schema-registry","schema-validation"],"created_at":"2024-08-01T16:01:01.382Z","updated_at":"2025-12-12T01:16:57.503Z","avatar_url":"https://github.com/raystack.png","language":"Go","readme":"# Stencil\n\n![Test](https://github.com/raystack/stencil/actions/workflows/test-server.yaml/badge.svg)\n![Release](https://github.com/raystack/stencil/actions/workflows/release-server.yml/badge.svg)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?logo=apache)](LICENSE)\n[![Version](https://img.shields.io/github/v/release/raystack/stencil?logo=semantic-release)](Version)\n\nStencil is a schema registry that provides schema mangement and validation to ensure data compatibility across applications. It enables developers to create, manage and consume schemas dynamically, efficiently, and reliably, and provides a simple way to validate data against those schemas. Stencil support multiple formats including Protobuf, Avro and JSON.\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"./docs/static/assets/overview.svg\" /\u003e\u003c/p\u003e\n\n## Key Features\n\nDiscover why users choose Stencil as their main schema registry\n\n- **Version history** Stencil stores versioned history of proto descriptor file on specified namespace and name\n- **Backward compatibility** enforce backward compatibility check on upload by default\n- **Flexbility** ability to skip some of the backward compatibility checks while upload\n- **Descriptor fetch** ability to download proto descriptor files\n- **Metadata** provides metadata API to retrieve latest version number given a name and namespace\n- **Clients in multiple languages** Stencil provides clients in GO, Java, JS languages to interact with Stencil server and deserialize messages using dynamic schema\n\n## Documentation\n\nExplore the following resources to get started with Stencil:\n\n- [Documentation](http://raystack.github.io/stencil) provides guidance on using stencil.\n- [Server](https://raystack.github.io/stencil/docs/server/overview) provides details on getting started with stencil server.\n- [Clients](https://raystack.github.io/stencil/docs/clients/overview) provides reference to supported stencil clients.\n\n## Installation\n\nInstall Stencil on macOS, Windows, Linux, OpenBSD, FreeBSD, and on any machine.\n\n#### Binary (Cross-platform)\n\nDownload the appropriate version for your platform from [releases](https://github.com/raystack/stencil/releases) page. Once downloaded, the binary can be run from anywhere.\nYou don’t need to install it into a global location. This works well for shared hosts and other systems where you don’t have a privileged account.\nIdeally, you should install it somewhere in your PATH for easy use. `/usr/local/bin` is the most probable location.\n\n#### MacOS\n\n`stencil` is available via a Homebrew Tap, and as downloadable binary from the [releases](https://github.com/raystack/stencil/releases/latest) page:\n\n```sh\nbrew install raystack/tap/stencil\n```\n\nTo upgrade to the latest version:\n\n```sh\nbrew upgrade stencil\n```\n\n#### Linux\n\n`stencil` is available as downloadable binaries from the [releases](https://github.com/raystack/stencil/releases/latest) page. Download the `.deb` or `.rpm` from the releases page and install with `sudo dpkg -i` and `sudo rpm -i` respectively.\n\n#### Windows\n\n`stencil` is available via [scoop](https://scoop.sh/), and as a downloadable binary from the [releases](https://github.com/raystack/stencil/releases/latest) page:\n\n```sh\nscoop bucket add stencil https://github.com/raystack/scoop-bucket.git\n```\n\nTo upgrade to the latest version:\n\n```sh\nscoop update stencil\n```\n\n#### Docker\n\nWe provide ready to use Docker container images. To pull the latest image:\n\n```sh\ndocker pull raystack/stencil:latest\n```\n\nTo pull a specific version:\n\n```sh\ndocker pull raystack/stencil:v0.5.1\n```\n\n## Usage\n\nStencil has three major components. Server, CLI and clients. Stencil server and CLI are bundled in a single binary.\n\n**Server**\n\nStencil server provides a way to store and fetch schemas and enforce compatibility rules. Run `stencil server --help` to see instructions to manage Stencil server.\n\nStencil server also provides a fully-featured GRPC and HTTP API to interact with Stencil server. Both APIs adheres to a set of standards that are rigidly followed. Please refer to [proton](https://github.com/raystack/proton/tree/main/raystack/stencil/v1beta1) for GRPC API definitions.\n\n**CLI**\n\nStencil CLI allows users to iteract with server to create, view, and search schemas. CLI is fully featured but simple to use, even for those who have very limited experience working from the command line. Run `stencil --help` to see list of all available commands and instructions to use.\n\n**Clients**\n\nStencil clients allows application to interact with stencil server to eserialize and deserialize messages using schema. Stencil supports clients in multiple languages.\n\n- [Java](clients/java)\n- [Go](clients/go)\n- [Javascript](clients/js)\n- [Clojure](clients/clojure)\n- Ruby - Coming soon\n- Python - Coming soon\n\n## Running locally\n\n\u003cdetails\u003e\n  \u003csummary\u003eDependencies:\u003c/summary\u003e\n\n    - Git\n    - Go 1.16 or above\n    - Yarn (Needed for UI)\n    - PostgreSQL 13 or above\n\n\u003c/details\u003e\n\n```sh\n# Clone the repo\n$ git clone git@github.com:raystack/stencil.git\n\n# Check all build comamnds available\n$ make help\n\n# Build meteor binary file\n$ make build\n\n# Init server config\n$ cp config/config.yaml config.yaml\n\n# Run database migrations\n$ ./stencil server migrate\n\n# Start stencil server\n$ ./stencil server start\n```\n\n## Running tests\n\n```sh\n# Running all unit tests\n$ make test\n\n# Print code coverage\n$ make coverage\n```\n\n## Contribute\n\nDevelopment of Stencil happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving stencil.\n\nRead our [contributing guide](docs/docs/contribute/contribution.md) to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to stencil.\n\nTo help you get your feet wet and get you familiar with our contribution process, we have a list of [good first issues](https://github.com/raystack/stencil/labels/good%20first%20issue) that contain bugs which have a relatively limited scope. This is a great place to get started.\n\nThis project exists thanks to all the [contributors](https://github.com/raystack/stencil/graphs/contributors).\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraystack%2Fstencil","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraystack%2Fstencil","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraystack%2Fstencil/lists"}