> ## 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.

# Astro IDE Quickstart

<Info>
  **Preview**

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

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](/docs/astro/manage-workspaces).

<Note>
  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.
</Note>

<Steps>
  <Step title="Log in and create a project">
    1. Log in to the Astro UI.
    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**](/docs/astro/ide-import-github-project) – Use the Astro GitHub integration to directly import a repository.
       * [**Connect a project from any Git provider**](/docs/astro/ide-import-git-project) – Configure a manual connection for GitLab, Bitbucket, Azure Repos, or any generic Git provider.
       * [**Connect CLI Project**](/docs/astro/ide-import-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.

    <Note>
      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.
    </Note>
  </Step>

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

    ```text wrap theme={null}
    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.
    ```

    <Note>
      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.
    </Note>

    2. The Astro IDE generates the code and display the proposed changes in the suggested changes panel.
    3. 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.
  </Step>

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

    <Note>
      Instead of starting an ephemeral test Deployment, you can open the **Test** tab and click **Use an existing Deployment** to test against an Astro Deployment your team already runs. See [Test against an existing Deployment](/docs/astro/ide-test-run#test-against-an-existing-deployment).
    </Note>

    <Info>
      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.
    </Info>

    2. Open the **Test** tab and select **hello\_world\_dag** from the Dag options.
    3. Click **Run Task** to execute the Dag.
    4. Confirm the task ran successfully by checking the **Task Logs**.
  </Step>
</Steps>

<Info>
  You can also view your ephemeral test Deployment in the Airflow UI by clicking **Open Airflow** from the toolbar menu.
</Info>

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