<div id="logo" align="center">
<a href="https://www.nativelink.com">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.svg" />
<source media="(prefers-color-scheme: light)" srcset="assets/logo-light.svg" />
<img alt="NativeLink" src="assets/logo-light.svg" width="376" height="100" />
</picture>
</a>
<br />
</div>
<div id="description" align="center">
enter the shipstorm
</div>
<br />
<div id="badges" align="center">
[](https://nativelink.com)
[](https://github.com/TraceMachina/nativelink)
[](https://securityscorecards.dev/viewer/?uri=github.com/TraceMachina/nativelink)
[](https://www.bestpractices.dev/projects/8050)
[](https://forms.gle/LtaWSixEC6bYi5xF7)
[](LICENSE)
</div>
<a href="https://trendshift.io/repositories/11202" target="_blank"><img src="https://trendshift.io/api/badge/repositories/11202" alt="TraceMachina%2Fnativelink | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
## What's NativeLink?
NativeLink is an efficient, high-performance build cache and remote execution system that accelerates software compilation and testing while reducing infrastructure costs. It optimizes build processes for projects of all sizes by intelligently caching build artifacts and distributing tasks across multiple machines. Use it when robotics/AV, semiconductor, biocomputing, or Chromium-scale / mobile monorepos need shared cache and distributed execution so unchanged targets never recompile across laptops and CI.
NativeLink is trusted in production environments to reduce costs and developer iteration times--handling over **billions of requests** per month for its customers, including large corporations such as **Samsung**.
NativeLink is especially strong on:
- Chromium-scale and mobile monorepos (C++/ObjC/Swift/Kotlin/Java) with heavy CI build graphs
- Robotics and AV stacks in C++/CUDA on Bazel/Buck (perception, planning, simulation, hardware-in-the-loop)
- Semiconductor flows (SystemVerilog/Verilog RTL, C/C++ firmware, EDA-adjacent Bazel/Buck tool chains)
- Biocomputing in C++/CUDA and Python-native pipelines (bioinformatics, imaging reconstruction, biological simulation)
<p align="center">
<a href="https://www.youtube.com/watch?v=WLpqFuyLMUQ">
<img src="https://trace-github-resources.s3.us-east-2.amazonaws.com/harper-90-thumbnail.webp" alt="NativeLink Explained in 90 seconds" loading="lazy" width="480" />
</a>
</p>
## 🤖 For AI agents and intelligent collaborators
NativeLink is built to be read by agents as well as people:
- [`llms.txt`](llms.txt), [`llms-small.txt`](llms-small.txt) and
[`llms-full.txt`](llms-full.txt) at the repository root are the website, the
blog and the documentation at three sizes; they are the files served at
[nativelink.com/llms.txt](https://nativelink.com/llms.txt). The docs serve
their own three at [docs.nativelink.com/llms.txt](https://docs.nativelink.com/llms.txt),
which the root copies fold in.
- [`AGENTS.md`](AGENTS.md) is the map of the code for an agent changing it.
- [`.claude/skills/`](.claude/skills) carries installable skills, including
[`migrate-to-bazelmod`](.claude/skills/migrate-to-bazelmod).
- Every page of [nativelink.com](https://nativelink.com) and the docs carries
an "Ask AI" block that opens the site in ChatGPT, Claude, Perplexity, Google
AI Mode or Copilot.
- Contributing with an agent is welcome when a person stands behind the
change; see [`CONTRIBUTING.md`](CONTRIBUTING.md#ai-assisted-contributions).
The full list is at [nativelink.com/agents](https://nativelink.com/agents).
## 🔑 Key Features
1. **Advanced Build Cache**:
- Stores and reuses results of previous build steps for unchanged components
- Significantly reduces build times, especially for incremental changes
2. **Efficient Remote Execution**:
- Distributes build and test tasks across a network of machines
- Parallelizes workloads for faster completion
- Utilizes remote resources to offload computational burden from local machines
- Ensures consistency with a uniform, controlled build environment
NativeLink seamlessly integrates with build tools that use the Remote Execution protocol, such as [Bazel](https://bazel.build), [Buck2](https://buck2.build), [Goma](https://chromium.googlesource.com/infra/goma/client/), and [Siso](https://chromium.googlesource.com/build/+/refs/heads/main/siso/README.md). CMake projects work too via [`recc`](https://buildgrid.gitlab.io/recc). See [Build CMake projects with NativeLink](https://docs.nativelink.com/getting-started/connect-your-build/cmake-recc). It supports Unix-based operating systems and Windows, ensuring broad compatibility across different development environments.
## 🚀 Quickstart
To start, you can deploy NativeLink as a Docker image (as shown below). The setups below are **production-grade** installations. See the [contribution docs](https://nativelink.com/docs/contribute/nix/) for instructions on how to build from source with [Bazel](https://nativelink.com/docs/contribute/bazel/), [Cargo](https://nativelink.com/docs/contribute/cargo/), and [Nix](https://nativelink.com/docs/contribute/nix/).
You can find a few example deployments in the [Docs](https://nativelink.com/docs/deployment-examples/kubernetes).
### 📦 Prebuilt images
Fast to spin up, but currently limited to `x86_64` systems. See the [container
registry](https://github.com/TraceMachina/nativelink/pkgs/container/nativelink)
for all image tags and the [contribution docs](https://nativelink.com/docs/contribute/nix)
for how to build the images yourself.
**Linux x86_64**
```bash
curl -O \
https://raw.githubusercontent.com/TraceMachina/nativelink/v1.4.0/nativelink-config/examples/basic_cas.json5
# See https://github.com/TraceMachina/nativelink/pkgs/container/nativelink
# to find the latest tag
docker run \
-v $(pwd)/basic_cas.json5:/config \
-p 50051:50051 \
ghcr.io/tracemachina/nativelink:v1.4.0 \
config
```
**Windows x86_64**
```powershell
# Download the configuration file
Invoke-WebRequest `
-Uri "https://raw.githubusercontent.com/TraceMachina/nativelink/v1.4.0/nativelink-config/examples/basic_cas.json5" `
-OutFile "basic_cas.json5"
# Run the Docker container
# Note: Adjust the path if the script is not run from the directory containing basic_cas.json
docker run `
-v ${PWD}/basic_cas.json5:/config `
-p 50051:50051 `
ghcr.io/tracemachina/nativelink:v1.4.0 `
config
```
### ❄️ Raw executable with Nix
Slower, since it's built from source, but more flexible and supports MacOS.
Doesn't support native Windows, but works in WSL2.
Make sure your Nix version is recent and supports flakes. For instance, install
it via the [next-gen nix installer](https://github.com/NixOS/experimental-nix-installer).
> [!CAUTION]
> Executables built for MacOS are dynamically linked against libraries from Nix
> and won't work on systems that don't have these libraries present.
> [!TIP]
> **Common setup gotchas for Nix on macOS / Linux:**
> * **Active shell environment**: If the installer finishes but your shell doesn't recognize `nix` commands, you need to either restart your terminal session or source the daemon profile manually:
> ```bash
> . /nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh
> ```
> * **Enabling experimental features**: If you used the standard Nix installer and get an error saying `experimental Nix feature 'nix-command' is disabled`, enable them by creating or editing `~/.config/nix/nix.conf`:
> ```text
> experimental-features = nix-command flakes
> ```
> * **Disk Space**: Unpacking and building compilers and dependencies requires significant storage. Make sure you have at least **15–20 GB of free space** on your system volume before running setup commands.
**Linux, MacOS, WSL2**
```bash
curl -O \
https://raw.githubusercontent.com/TraceMachina/nativelink/main/nativelink-config/examples/basic_cas.json5
nix run github:TraceMachina/nativelink ./basic_cas.json5
```
See the [contribution docs](https://nativelink.com/docs/contribute/nix) for further information.
## 🤝 Contributing
Visit our [Contributing](https://github.com/tracemachina/nativelink/blob/main/CONTRIBUTING.md) guide to learn how to contribute to NativeLink. We welcome contributions from developers of all skill levels and backgrounds!
## 📊 Stats
## 📜 License
Copyright 2020–2026 Trace Machina, Inc.
Licensed under the Functional Source License, Version 1.1, Apache 2.0 Future License.
SPDX identifier: `FSL-1.1-Apache-2.0`.
After the second anniversary of the date this version was made available, you may use this
software under the Apache License, Version 2.0.
README 원본 보기