> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Import GitHub projects to the Astro IDE

<Info>
  **Preview**

  This feature is in [Preview](/docs/astro/feature-previews).
</Info>

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

## Connect a GitHub project

### Prerequisites

* A configured [Astro GitHub integration](/docs/astro/deploy-github-integration).
* [Workspace Author](/docs/astro/user-permissions) permissions.
* Project size under 200 MB and individual file sizes under 1 MB. See [Project requirements](/docs/astro/ide-overview#project-requirements).

<Steps>
  <Step title="Open the Astro IDE">
    From the Astro UI main menu, select **Astro IDE**.
  </Step>

  <Step title="Open the Projects tab">
    Click **Projects** to open the Projects tab.
  </Step>

  <Step title="Click &#x22;+ Add Project&#x22;">
    Click **+ Add Project**, then select **Import Git Project** from the dropdown menu.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Connect">
    Click **Connect** to import your project. The Astro IDE can now load your repository and set up your environment.
  </Step>
</Steps>

## 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](#connect-a-github-project) to import a GitHub project if you haven't already.

<Steps>
  <Step title="Open the Astro IDE">
    From the Astro UI main menu, select **Astro IDE**.
  </Step>

  <Step title="Open the Projects tab">
    Click **Projects** to open the Projects tab.
  </Step>

  <Step title="Select your imported project">
    Click **New Session** next to the project you imported to start a new session with that project.
  </Step>
</Steps>

<Tip>
  **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.
</Tip>