Apache Gravitino is a high-performance, geo-distributed, and federated metadata lake. It manages metadata directly in different sources, types, and regions and provides users with unified metadata access for data and AI assets.

Gravitino aims to provide several key features:

• Single Source of Truth for multi-regional data with geo-distributed architecture support.
• Unified Data and AI asset management for both users and engines.
• Security in one place, centralizing the security for different sources.
• Built-in data management and data access management.

Gravitino is open source software available under the Apache 2.0 license. For information on how to contribute to Gravitino, please see the Contribution guidelines.

The latest Gravitino documentation is available on our official website. This README file only contains basic setup instructions.

You can build Gravitino using Gradle. Currently, you can build Gravitino on Linux and macOS, and Windows isn't supported.

To build Gravitino, please run:

./gradlew clean build -x test

If you want to build a distribution package, please run:

./gradlew compileDistribution -x test

to build a distribution package.

Or:

./gradlew assembleDistribution -x test

to build a compressed distribution package.

The directory distribution contains the generated binary distribution package.

Please see How to build Gravitino for details on building and testing Gravitino.

This is the most recommended way: Gravitino provides a docker-compose based playground to quickly experience the whole system together with other components. Clone or download the Gravitino playground repository and then follow the README, you will have all then.

If you want to start Gravitino in your machine, download a binary package from the download page, and then decompressed the package.

Before starting the Gravitino server, please configure the Gravitino server configuration file. The configuration file, gravitino.conf, is in the conf directory and follows the standard property file format. You can modify the configuration within this file.

To start the Gravitino server, please run:

./bin/gravitino.sh start

To stop the Gravitino server, please run:

./bin/gravitino.sh stop

Alternatively, to run the Gravitino server in the frontend, please run:

./bin/gravitino.sh run

And press CTRL+C to stop the Gravitino server.

Gravitino provides Iceberg REST catalog service to manage Iceberg. For more details, please refer to Gravitino Iceberg REST catalog service.

Gravitino provides a Trino connector to access the metadata in Gravitino. To use Trino with Gravitino, please follow the trino-gravitino-connector doc.

1. How to build Gravitino
2. How to test Gravitino
3. How to publish Docker images

Gravitino is licensed under the Apache License Version 2.0. For details, see the LICENSE.

Apache Gravitino is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required for all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

_{Apache®, Apache Gravitino™, Apache Hadoop®, Apache Hive™, Apache Iceberg™, Apache Kafka®, Apache Spark™, Apache Submarine™, Apache Thrift™ and Apache Zeppelin™ are either registered trademarks or trademarks of the Apache Software Foundation in the United States and/or other countries.}