MCPcopy
hub / github.com/treeverse/lakeFS

github.com/treeverse/lakeFS @v1.82.0 sqlite

repository ↗ · DeepWiki ↗ · release v1.82.0 ↗
20,587 symbols 68,752 edges 1,595 files 9,348 documented · 45%
README

<a href="https://raw.githubusercontent.com/treeverse/lakeFS/master/LICENSE" >
    <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="Apache License" /></a>
<a href="https://github.com/treeverse/lakeFS/actions/workflows/test.yaml?query=branch%3Amaster">
    <img src="https://github.com/treeverse/lakeFS/workflows/Test/badge.svg?branch=master" alt="Go tests status" /></a>
<a href="https://github.com/treeverse/lakeFS/actions/workflows/node.yaml?query=branch%3Amaster" >
    <img src="https://github.com/treeverse/lakeFS/workflows/Node/badge.svg?branch=master" alt="Node tests status" /></a>
<a href="https://github.com/treeverse/lakeFS/actions/workflows/esti.yaml?query=branch%3Amaster">
    <img src="https://github.com/treeverse/lakeFS/workflows/Esti/badge.svg?branch=master" alt="Integration tests status" /></a>
<a href="https://artifacthub.io/packages/search?repo=lakefs">
    <img src="https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/lakefs" alt="Artifact HUB" /></a>
<a href="https://github.com/treeverse/lakeFS/raw/v1.82.0/CODE_OF_CONDUCT.md">
    <img src="https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg" alt="code of conduct"></a>

lakeFS is Data Version Control (Git for Data)

lakeFS is an open-source tool that transforms your object storage into a Git-like repository. It enables you to manage your data lake the way you manage your code.

With lakeFS you can build repeatable, atomic, and versioned data lake operations - from complex ETL jobs to data science and analytics.

lakeFS supports AWS S3, Azure Blob Storage, and Google Cloud Storage as its underlying storage service. It is API compatible with S3 and works seamlessly with all modern data frameworks such as Spark, Hive, AWS Athena, DuckDB, and Presto.

For more information, see the documentation.

Getting Started

You can spin up a standalone sandbox instance of lakeFS:

pip install lakefs
python -m lakefs.quickstart

Once you've got lakeFS running, open http://127.0.0.1:8000/ in your web browser.

Getting Started with Docker

Alternatively, you can run lakeFS a server using Docker:

docker run --pull always \
           --name lakefs \
           -p 8000:8000 \
           treeverse/lakefs:latest \
           run --quickstart

Quickstart

👉🏻 For a hands-on walk through of the core functionality in lakeFS head over to the quickstart to jump right in!

Make sure to also have a look at the lakeFS samples. These are a rich resource of examples of end-to-end applications that you can build with lakeFS.

Why Do I Need lakeFS?

ETL Testing with Isolated Dev/Test Environment

When working with a data lake, it’s useful to have replicas of your production environment. These replicas allow you to test these ETLs and understand changes to your data without impacting downstream data consumers.

Running ETL and transformation jobs directly in production without proper ETL Testing is a guaranteed way to have data issues flow into dashboards, ML models, and other consumers sooner or later. The most common approach to avoid making changes directly in production is to create and maintain multiple data environments and perform ETL testing on them. Dev environment to develop the data pipelines and test environment where pipeline changes are tested before pushing it to production. With lakeFS you can create branches, and get a copy of the full production data, without copying anything. This enables a faster and easier process of ETL testing.

Reproducibility

Data changes frequently. This makes the task of keeping track of its exact state over time difficult. Oftentimes, people maintain only one state of their data––its current state.

This has a negative impact on the work, as it becomes hard to: * Debug a data issue. * Validate machine learning training accuracy (re-running a model over different data gives different results). Comply with data audits.

In comparison, lakeFS exposes a Git-like interface to data that allows keeping track of more than just the current state of data. This makes reproducing its state at any point in time straightforward.

Write-Audit-Publish

Data pipelines feed processed data from data lakes to downstream consumers like business dashboards and machine learning models. As more and more organizations rely on data to enable business critical decisions, data reliability and trust are of paramount concern. Thus, it’s important to ensure that production data adheres to the data governance policies of businesses. These data governance requirements can be as simple as a file format validation, schema check, or an exhaustive PII(Personally Identifiable Information) data removal from all of organization’s data.

Thus, to ensure the quality and reliability at each stage of the data lifecycle, data quality gates need to be implemented. That is, we need to run quality and correctness tests on the data, and only if data governance requirements are met can the data can be published to production for business use.

Everytime there is an update to production data, the best practice would be to run tests and then publish (deploy) the data to production. With lakeFS you can create hooks that make sure that only data that passed these tests will become part of production.

Rollback

A rollback operation is used to to fix critical data errors immediately.

What is a critical data error? Think of a situation where erroneous or misformatted data causes a signficant issue with an important service or function. In such situations, the first thing to do is stop the bleeding.

Rolling back returns data to a state in the past, before the error was present. You might not be showing all the latest data after a rollback, but at least you aren’t showing incorrect data or raising errors. Since lakeFS provides versions of the data without making copies of the data, you can time travel between versions and roll back to the version of the data before the error was presented.

Community

Stay up to date and get lakeFS support via:

  • Share your lakeFS experience and get support on our Slack.
  • Follow us and join the conversation on Twitter.
  • Learn from video tutorials on our YouTube channel.
  • Read more on data versioning and other data lake best practices in our blog.
  • Feel free to contact us about anything else.

More information

Licensing

lakeFS is completely free and open-source and licensed under the Apache 2.0 License.

Treeverse considers that any sharing of source code with an AI agent, and any output an AI agent generates based on our source code, without the appropriate notices or attribution requirements, violates the terms of the Apache 2.0 license to which this source code is subject. We also do not consider AI provider guardrails as sufficient to prevent copyright infringement. Treeverse reserves all of its rights to pursue legal action against any party that inputs LakeFS code into an AI agent.

Who Uses lakeFS?

lakeFS is used by numerous companies, including those below. If you use lakeFS and would like to be included here please open a PR.

  • AirAsia
  • APEX Global
  • AppsFlyer
  • Auburn University
  • BAE Systems
  • Bureau of Labor Statistics
  • Cambridge Consultants
  • Connor, Clark & Lunn Financial Group
  • Context Labs Bv
  • Daimler Truck
  • Enigma
  • EPCOR
  • Ford Motor Company
  • Generali
  • Giesecke+Devrient
  • greehill
  • Karius
  • Luxonis
  • Mixpeek
  • Netflix
  • Paige
  • PETRONAS
  • Pollinate
  • Proton Technologies AG
  • ProtonMail
  • Renaissance Computing Institute
  • RHEA Group
  • RMS
  • Sensum
  • Similarweb
  • State Street Global Advisors
  • Terramera
  • Tredence
  • Volvo Cars
  • Webiks
  • Windward
  • Woven by Toyota

Extension points exported contracts — how you extend this code

Hook (Interface)
Hook is the abstraction of the basic user-configured runnable building-stone [8 implementers]
pkg/actions/hook.go
Driver (Interface)
Driver is the interface to access a kv database as a Store. Each kv provider implements a Driver. [13 implementers]
pkg/kv/store.go
Collaborator (Interface)
Collaborator TODO (niro): This should eventually exist in a separate service [11 implementers]
pkg/graveler/graveler.go
Credentialler (Interface)
Credentialler fetches S3-style credentials for access keys. [12 implementers]
pkg/auth/authenticator.go
Adapter (Interface)
Adapter abstract Storage Adapter for persistence of version controlled data. The methods generally map to S3 API methods [8 …
pkg/block/adapter.go
File (Interface)
File is pyramid abstraction for an os.File [5 implementers]
pkg/pyramid/pyramid.go
ExternalPrincipalLoginCaller (Interface)
(no doc) [8 implementers]
pkg/authentication/externalidp/awsiam/iam_client.go
Statuser (Interface)
(no doc) [176 implementers]
pkg/api/controller_test.go

Core symbols most depended-on inside this repo

get
called by 2620
clients/hadoopfs/src/main/java/io/lakefs/FSConfiguration.java
getValue
called by 2082
clients/java/src/main/java/io/lakefs/clients/sdk/model/Diff.java
append
called by 1903
clients/hadoopfs/src/main/java/io/lakefs/LakeFSFileSystem.java
Errorf
called by 1535
pkg/logging/logger.go
getKey
called by 1385
clients/java/src/main/java/io/lakefs/clients/sdk/model/Setup.java
Get
called by 1049
pkg/arena/arena.go
Contains
called by 997
pkg/graveler/graveler.go
Error
called by 993
pkg/logging/logger.go

Shape

Method 13,708
Function 3,834
Struct 1,338
Class 1,156
TypeAlias 268
Interface 184
FuncType 70
Enum 19
Route 10

Languages

Go53%
Java31%
Python12%
TypeScript4%

Modules by API surface

pkg/api/apigen/lakefs.gen.go2,047 symbols
pkg/graveler/mock/graveler.go462 symbols
clients/java/src/main/java/io/lakefs/clients/sdk/AuthApi.java448 symbols
pkg/auth/client.gen.go446 symbols
pkg/graveler/graveler.go429 symbols
clients/java/src/main/java/io/lakefs/clients/sdk/InternalApi.java340 symbols
clients/java/src/main/java/io/lakefs/clients/sdk/ExperimentalApi.java219 symbols
pkg/catalog/catalog.go181 symbols
pkg/api/controller.go181 symbols
clients/java/src/main/java/io/lakefs/clients/sdk/RepositoriesApi.java169 symbols
webui/src/lib/api/index.js168 symbols
contrib/auth/apigen/authapi.gen.go148 symbols

Dependencies from manifests, versioned

4d63.com/gocheckcompilerdirectivesv1.3.0 · 1×
4d63.com/gochecknoglobalsv0.2.2 · 1×
cel.dev/exprv0.25.1 · 1×
cloud.google.com/gov0.123.0 · 1×
cloud.google.com/go/authv0.18.2 · 1×
cloud.google.com/go/auth/oauth2adaptv0.2.8 · 1×
cloud.google.com/go/compute/metadatav0.9.0 · 1×
cloud.google.com/go/monitoringv1.24.3 · 1×
cloud.google.com/go/storagev1.60.0 · 1×
codeberg.org/chavacava/garifv0.2.0 · 1×
dario.cat/mergov1.0.2 · 1×

Datastores touched

postgresDatabase · 1 repos
(mysql)Database · 1 repos
lakefe_dbDatabase · 1 repos

For agents

$ claude mcp add lakeFS \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact