Opinionated. Declarative. Reproducible.

Airfield: The Robotics Engineering & AI Research Framework

Airfield is the opinionated, declarative framework for robotics engineering and AI research. It is built on the principles of 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 or training cluster, even when multiple developers are working on the same system.

Declarative Orchestration

Bring up your robot stack from declarative package plans. Airfield keeps package boundaries explicit while generating repeatable launch workflows for development and productionization.

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.