For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
      • AstroFully-managed data operations, powered by Apache Airflow.
      • Astro Private CloudRun Airflow-as-a-service in your environment.
      • Professional ServicesExpert Airflow services for your enterprise's success.
    • Tools
      • Cosmos
      • Orbiter
      • CLI
      • AI SDK
      • Agents
      • Blueprint
      • UpdatesThe State of Airflow 2026See the insights from over 5,800 data practitioners in the full report. Download Now ➔
  • Customers
  • Docs
    • Insights
      • Blog
      • Webinars
      • Resource Library
      • Events
    • Education
      • Academy
      • What is Airflow?
  • Pricing
Get Started Free
    • Overview
      • Overview
        • Overview
        • Quickstart
        • Author dags
        • Blueprint
        • Test and run dags
      • Dag versioning
      • Airflow logs
      • DAG and task runs
      • Airflow REST API
    • Book Office Hours

Product

  • Platform Overview
  • Astro
  • Astro Observe
  • Astro Private Cloud
  • Security & Trust
  • Pricing

Tools & Services

  • Cosmos
  • Docs
  • Professional Services
  • Product Updates

Use Cases

  • AI Ops
  • Data Observability
  • ETL/ELT
  • ML Ops
  • Operational Analytics
  • All Use Cases

Industries

  • Financial Services
  • Gaming
  • Retail
  • Manufacturing
  • Healthcare
  • All Industries

Resources

  • Academy
  • eBooks & Guides
  • Blog
  • Webinars
  • Events
  • The Data Flowcast Podcast
  • All Resources

Airflow

  • What is Airflow
  • Airflow on Astro
  • Airflow 3.0
  • Airflow Upgrades
  • Airflow Use Cases
  • Airflow 2.x End of Life

Company

  • Our Story
  • Customers
  • Newsroom
  • Careers
  • Contact

Support

  • Knowledge Base
  • Status
  • Contact Support
GitHubYouTubeLinkedInx
  • Legal
  • Privacy
  • Terms of Service
  • Consent Preferences

  • Do Not Sell or Share My Personal information
  • Limit the Use Of My Sensitive Personal Information

Apache Airflow®, Airflow, and the Airflow logo are trademarks of the Apache Software Foundation. Copyright © Astronomer 2026. All rights reserved.

LogoLogo
On this page
  • Prerequisites
Develop DAGsAstro IDE

Astro IDE Quickstart

Edit this page
Built with
Preview
This feature is in Preview.

Get started with Astro IDE by entering a prompt, deploying to an ephemeral test Deployment, and testing your Airflow dag.

Prerequisites

  • Workspace Operator permissions in an Astro Workspace.

Workspace Author permissions let you create and edit projects with the Astro IDE, but you need Workspace Operator permissions to start an ephemeral test Deployment.

1

Log in and create a project

  1. Log in to the Astro UI and select a Workspace.
  2. Click Astro IDE in the menu. If you are the first person in your Workspace to use the Astro IDE, the Projects page is empty.
  3. You have several options to get started in the Astro IDE:
    • Connect GitHub Project – Use the Astro GitHub integration to directly import a repository.
    • Connect a project from any Git provider – Configure a manual connection for GitLab, Bitbucket, Azure Repos, or any generic Git provider.
    • Connect CLI Project – Upload a local Astro project using the CLI.
    • Enter a prompt in the text box describing what kind of pipeline you want to build. The Astro IDE will generate a new project from your prompt.
  4. This quickstart guides you through creating a new project from a prompt.

Projects in the Astro IDE are visible to all members of your Workspace, but sessions are private. Only you can see and access your own sessions and conversation history.

2

Prompt, review, and accept your first dag

  1. In the Astro IDE, enter the following prompt in the text box describing the Hello World dag you want to build. The more specific the prompt is, the better the agent performs. For this quickstart, enter:
Generate a dag called hello_world_dag that prints 'Hello World' to the logs. The dag should:
- Not require the scheduler to be running.
- Contain a single PythonOperator task named print_hello.

The Astro IDE ephemeral test environment sets AIRFLOW__SCHEDULER__USE_JOB_SCHEDULE=false by default. This means scheduled or downstream tasks do not run automatically. This setting enables the Test tab to give you direct, manual control over when tasks run, instead of relying on Airflow’s scheduler.

  1. The Astro IDE generates the code and display the proposed changes in the suggested changes panel.
  2. Review the changes, and iterate on them with the AI panel. Once you are satisfied with the changes, click the Keep changes (✔️) button in the panel to approve the new dag.
3

Deploy and test

  1. After you accept a code change, click Start Test Deployment to test your changes. This deploys the generated code to an ephemeral test Deployment that allows you to run tasks and view logs.

AI can make mistakes, and the generated code can sometimes throw an import error. If you have an import error, the hello_world_dag doesn’t appear in the Test tab, and the IDE lists the error in the Import Errors of the Test Output pane. To fix the error, paste the error message into the prompt box, so the IDE can suggest edits. Review the suggested changes, accept them, and click Sync to Test to update the Deployment.

  1. Open the Test tab and select hello_world_dag from the dag options.
  2. Click Run Task to execute the dag.
  3. Confirm the task ran successfully by checking the Task Logs.

You can also view your ephemeral test Deployment in the Airflow UI by clicking Open Airflow from the toolbar menu.

Your session persists even if you close your browser. The AI agent continues processing prompts in the background, and your full conversation history is preserved. Return to the Astro IDE at any time to resume where you left off.