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
          • Import a CLI project
          • Import project with Astro GitHub integration
          • Import a Git project
        • 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
  • Connect a GitHub project
  • Prerequisites
  • Start a new session with your imported project
  • Prerequisites
Develop DAGsAstro IDEImport projects

Import GitHub projects to the Astro IDE

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

Import an existing project into the Astro IDE by connecting your GitHub repository.

Connect a GitHub project

Prerequisites

  • A configured Astro GitHub integration.
  • Workspace Author permissions.
  • Project size under 200 MB and individual file sizes under 1 MB. See Project requirements.
1

Open the Astro IDE

From the Astro UI main menu, select Astro IDE.

2

Open the Projects tab

Click Projects to open the Projects tab.

3

Click ”+ Add Project”

Click + Add Project, then select Import Git Project from the dropdown menu.

4

Connect to a GitHub project

Click Connect to GitHub project…, then select a GitHub organization:

  • Choose your organization or personal GitHub account from the list.
  • Click Add an organization from GitHub if your organization isn’t listed, and follow the prompts.
5

Select repository and configure import

Select a repository.

  • Choose from the Repository list of options. The Astro IDE only allows you to select from repositories that the GitHub app is authorized to access.
  • (Optional) Enter the Astro Project Path if your Astro project isn’t in the repository root.
  • (Optional) Set a Git Branch. If not specified, the Astro IDE uses the default branch of the repository.
6

Connect

Click Connect to import your project. The Astro IDE can now load your repository and set up your environment.

Start a new session with your imported project

After importing your project, you can start a new session with it.

Prerequisites

You need to have an imported project in the Astro IDE. Follow the steps in Connect a GitHub project to import a GitHub project if you haven’t already.

1

Open the Astro IDE

From the Astro UI main menu, select Astro IDE.

2

Open the Projects tab

Click Projects to open the Projects tab.

3

Select your imported project

Click New Session next to the project you imported to start a new session with that project.

Resume a previous session

Once you have created a session with your imported project, you can close it, and later resume it. In the Astro IDE, go to the Sessions tab, and click the session you want to resume.