Opinionated. Declarative. Reproducible.

Airfield: The Robotics Framework

Airfield is the opinionated, declarative framework for building modern robotics systems. It is built on convention-over-configuration, isolated runtime environments, and declarative orchestration. Airfield helps keep shared systems reproducible while many people develop packages in parallel.

Quick Install

pipx install git+https://github.com/airfield/airfield.git
airfield system install-completion bash

Why Airfield?

Opinionated Design

Stop wrestling with boilerplate code and configurations. Airfield makes code and dependency management easy, so you can focus on building the algorithms that enable perception, planning, and control.

Reproducibility and Encapsulation

Airfield locks and isolates your package dependencies to allow your code to run on your laptop, in CI, and on the physical robot, even when multiple roboticists are working on the same system.

Declarative Orchestration

Bring up your complex robot stack with a single command. Define configurations declaratively and let Airfield do the heavy lifting. Airfield starts each process in its own backgrounded, interactive PTY, making debugging and productionization easy.

Documentation

Understand the model

Learn how Airfield's modular and declarative approach tames complexity.

Start building

Initialize a project, build a reproducible image, and launch a robot package.

Create a project

Set up a workspace with packages, dependency roots, and launch plans.

Create a package

Scaffold a new package, wrap existing ROS code, and define runnable commands.

Share dependencies

Check local dependency manifests and upstream them to the shared package repository.

Use the CLI

Review command namespaces, dependency manifests, and deterministic configuration.