Apache Airflow Code Editor

8.2.3 verified Fri May 01 auth: no python

An Apache Airflow plugin that provides a web-based code editor and file manager for managing DAGs and other files directly in the Airflow UI. Supports multiple file types, syntax highlighting, and various storage backends (local, S3, GCS). Current version is 8.2.3, compatible with Airflow 2.x and 3.x. Release cadence is irregular, with frequent bug fixes.

pip install airflow-code-editor

Common errors

error ModuleNotFoundError: No module named 'airflow_code_editor' ↓

cause Package not installed or not in the same Python environment as Airflow.

fix

Run pip install airflow-code-editor in the same environment where Airflow is installed.

error Airflow reports 'airflow_code_editor' not found in plugins ↓

cause Plugin not configured in airflow.cfg or environment variable.

fix

Set AIRFLOW__CORE__PLUGINS=airflow_code_editor and restart Airflow webserver and scheduler.

error ImportError: cannot import name 'CodeEditorPlugin' from 'airflow.plugins' ↓

cause Using the old import path which is removed in v8.x.

fix

Change import to: from airflow_code_editor import CodeEditorPlugin

Warnings

breaking Upgrading from v7.x to v8.x requires Airflow 3.0 compatibility. v8.x drops support for Airflow 1.x and 2.x. ↓

fix Ensure your Airflow version is >=3.0 before upgrading to v8.x. If using Airflow 2.x, stay on v7.x.

gotcha The plugin must be configured via environment variable or airflow.cfg before starting Airflow. It does not auto-register on pip install. ↓

fix Set AIRFLOW__CORE__PLUGINS=airflow_code_editor in your environment or add plugins = airflow_code_editor to the [core] section of airflow.cfg.

deprecated The old import path from airflow.plugins is deprecated and will be removed. Use from airflow_code_editor import CodeEditorPlugin. ↓

fix Update all imports to use the new package path.

gotcha When using S3/GCS mounts, ensure the Airflow worker has proper IAM permissions. The plugin does not warn on missing credentials. ↓

fix Verify cloud storage permissions before configuring mount paths.

Imports

CodeEditorPlugin

wrong

from airflow.plugins import CodeEditorPlugin

correct

from airflow_code_editor import CodeEditorPlugin

The plugin is a separate package, not part of core Airflow

AirflowCodeEditorPlugin
```
from airflow_code_editor import CodeEditorPlugin
```
The class is named CodeEditorPlugin

Quickstart

Install the plugin and enable it via configuration. After restarting Airflow, navigate to the /code-editor/ endpoint.

from airflow import DAG
from airflow_code_editor import CodeEditorPlugin

# Register the plugin (in airflow.cfg or via environment variable)
# export AIRFLOW__CORE__PLUGINS=airflow_code_editor
# Restart Airflow services

# The editor will be available at /code-editor/