{"id":21185600,"url":"https://github.com/raystack/compass","last_synced_at":"2026-04-02T23:04:42.901Z","repository":{"id":37824599,"uuid":"350430254","full_name":"raystack/compass","owner":"raystack","description":"Compass is an enterprise data catalog that makes it easy to find, understand, and govern data.","archived":false,"fork":false,"pushed_at":"2023-10-23T06:01:17.000Z","size":4918,"stargazers_count":63,"open_issues_count":14,"forks_count":7,"subscribers_count":13,"default_branch":"main","last_synced_at":"2024-07-30T17:59:43.215Z","etag":null,"topics":["data","dataops","discovery","lineage","metadata"],"latest_commit_sha":null,"homepage":"https://compass-raystack.vercel.app/","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":"2021-03-22T17:24:43.000Z","updated_at":"2024-05-02T09:47:21.000Z","dependencies_parsed_at":"2023-09-27T05:49:43.499Z","dependency_job_id":null,"html_url":"https://github.com/raystack/compass","commit_stats":null,"previous_names":["raystack/compass","odpf/compass","odpf/columbus"],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raystack%2Fcompass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raystack%2Fcompass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raystack%2Fcompass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raystack%2Fcompass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raystack","download_url":"https://codeload.github.com/raystack/compass/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225606462,"owners_count":17495551,"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":["data","dataops","discovery","lineage","metadata"],"created_at":"2024-11-20T18:17:15.351Z","updated_at":"2026-04-02T23:04:42.889Z","avatar_url":"https://github.com/raystack.png","language":"Go","readme":"# Compass\n\n![test workflow](https://github.com/raystack/compass/actions/workflows/test.yml/badge.svg)\n![release workflow](https://github.com/raystack/compass/actions/workflows/release.yml/badge.svg)\n[![Coverage Status](https://coveralls.io/repos/github/raystack/compass/badge.svg?branch=main)](https://coveralls.io/github/raystack/compass?branch=main)\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/compass?logo=semantic-release)](Version)\n\nCompass is a context engine that builds a knowledge graph of your organization's metadata, capturing entities, relationships, and lineage across systems and time, making it discoverable and queryable for both humans and AI agents.\n\nCritical organizational knowledge lives scattered across dozens of systems: services, datasets, applications, teams, configurations, decisions, and the relationships between them. Compass resolves observations from these sources into unified entities, constructs a temporal graph of their relationships, and indexes everything for both keyword and semantic search. The result is a context graph that stitches together what exists, who owns it, how it connects, and what changed over time, so both humans and AI agents can discover, traverse, and reason over the full picture.\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"./docs/static/assets/overview.svg\" /\u003e\u003c/p\u003e\n\n## Key Features\n\n- **Entity Resolution:** Resolve and deduplicate metadata observations from multiple sources into unified entities with stable identity.\n- **Knowledge Graph:** Store typed, directed relationships between entities including lineage, ownership, documentation, and custom edge types.\n- **Hybrid Search:** Combine keyword precision with semantic similarity using Postgres-native full-text search and pgvector embeddings.\n- **Graph Traversal:** Multi-hop traversal queries across the entity graph for impact analysis, dependency tracking, and path discovery.\n- **Context Composition:** Assemble schema, lineage, ownership, and quality signals into context documents ready for LLM consumption.\n- **AI Serving:** Expose the full graph as an MCP server so AI agents can discover, traverse, and reason over organizational knowledge.\n- **Extensibility:** Open type system for entities and relationships to support any kind of metadata across your infrastructure.\n\n## Documentation\n\nExplore the following resources to get started with Compass:\n\n- [Guides](https://compass-raystack.vercel.app/docs/guides) provides guidance on ingesting and querying metadata from Compass.\n- [Concepts](https://compass-raystack.vercel.app/docs/concepts) describes all important Compass concepts.\n- [Reference](https://compass-raystack.vercel.app/docs/reference) contains details about configurations, metrics and other aspects of Compass.\n- [Contribute](https://compass-raystack.vercel.app/docs/contribute/contribution.md) contains resources for anyone who wants to contribute to Compass.\n\n## Installation\n\nInstall Compass on macOS, Windows, Linux, OpenBSD, FreeBSD, and on any machine. \u003cbr/\u003eRefer this for [installations](https://compass-raystack.vercel.app/docs/installation) and [configurations](https://compass-raystack.vercel.app/docs/guides/configuration)\n\n#### Binary (Cross-platform)\n\nDownload the appropriate version for your platform from [releases](https://github.com/raystack/compass/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`compass` is available via a Homebrew Tap, and as downloadable binary from the [releases](https://github.com/raystack/compass/releases/latest) page:\n\n```sh\nbrew install raystack/tap/compass\n```\n\nTo upgrade to the latest version:\n\n```\nbrew upgrade compass\n```\n\n#### Linux\n\n`compass` is available as downloadable binaries from the [releases](https://github.com/raystack/compass/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`compass` is available via [scoop](https://scoop.sh/), and as a downloadable binary from the [releases](https://github.com/raystack/compass/releases/latest) page:\n\n```\nscoop bucket add compass https://github.com/raystack/scoop-bucket.git\n```\n\nTo upgrade to the latest version:\n\n```\nscoop update compass\n```\n\n#### Docker\n\nWe provide ready to use Docker container images. To pull the latest image:\n\n```\ndocker pull raystack/compass:latest\n```\n\nTo pull a specific version:\n\n```\ndocker pull raystack/compass:v0.6.0\n```\n\nIf you like to have a shell alias that runs the latest version of compass from docker whenever you type `compass`:\n\n```\nmkdir -p $HOME/.config/raystack\nalias compass=\"docker run -e HOME=/tmp -v $HOME/.config/raystack:/tmp/.config/raystack --user $(id -u):$(id -g) --rm -it -p 8080:8080/tcp raystack/compass:latest\"\n```\n\n## Usage\n\nCompass provides a CLI, Connect RPC API (HTTP + gRPC), and an MCP server for AI agents.\n\n#### CLI\n\nCompass CLI is fully featured and simple to use. Run `compass --help` to see all available commands.\n\n```\ncompass --help\n```\n\nPrint command reference\n\n```sh\ncompass reference\n```\n\n#### API\n\nCompass provides a Connect RPC API that supports both Connect (HTTP) and gRPC protocols. Please refer to [proton](https://github.com/raystack/proton/tree/main/raystack/compass/v1beta1) for API definitions.\n\n#### MCP Server\n\nCompass exposes an MCP server at `/mcp` for AI agent integration. MCP-compatible systems can connect and use tools like `search_entities`, `get_context`, and `impact`.\n\n## Contribute\n\nDevelopment of Compass happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements.\n\nRead compass [contribution guide](https://compass-raystack.vercel.app/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 Compass.\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/compass/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/compass/graphs/contributors).\n\n## License\n\nCompass is [Apache 2.0](LICENSE) licensed.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraystack%2Fcompass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraystack%2Fcompass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraystack%2Fcompass/lists"}