# Getting started

> **📝 Note**
>
> An LLM-optimized bundle of this entire section is available at [`section.md`](https://www.union.ai/docs/v1/union/user-guide/getting-started/section.md).
> This single file contains all pages in this section, optimized for AI coding agent context.

This section gives you a quick introduction to writing and running Union.ai workflows.

## Gather your credentials

After your administrator has onboarded you to Union.ai (see [Deployment](https://www.union.ai/docs/v1/union/deployment/page.md)), you should have the following at hand:

- Your Union.ai credentials.
- The URL of your Union.ai instance. We will refer to this as `<union-host-url>` below.

## Log into Union.ai

Navigate to the UI at `<union-host-url>` and log in with your credentials.
Once you have logged in you should see the Union.ai UI.

To get started, try selecting the default project, called `flytesnacks`, from the list of projects.
This will take you to `flytesnacks` project dashboard:

![Union.ai UI](https://www.union.ai/docs/v1/union/_static/images/quick-start/byoc-dashboard.png)

This dashboard gives you an overview of the workflows and tasks in your project.
Since you are just starting out, it will be empty.
To build and deploy your first workflow, the first step is to [set up your local environment](https://www.union.ai/docs/v1/union/user-guide/getting-started/local-setup/page.md).

## Subpages

- [Local setup](https://www.union.ai/docs/v1/union/user-guide/getting-started/local-setup/page.md)
  - Install `uv`
  - Ensure the correct version of Python is installed
  - Install the `union` CLI
  - Configure the connection to your cluster
  - Check your CLI configuration
- [First project](https://www.union.ai/docs/v1/union/user-guide/getting-started/first-project/page.md)
  - Create a new Union.ai project
  - Initialize a local project
- [Understanding the code](https://www.union.ai/docs/v1/union/user-guide/getting-started/understanding-the-code/page.md)
  - Python code
  - ImageSpec
  - Tasks
  - Workflow
  - pyproject.toml
  - uv.lock
- [Running your workflow](https://www.union.ai/docs/v1/union/user-guide/getting-started/running-your-workflow/page.md)
  - Python virtual environment
  - Run the code locally
  - Running remotely on Union.ai in the cloud
  - Register the workflow without running
  - Run the workflow from the Union.ai interface
  - View the workflow execution on Union.ai

---
**Source**: https://github.com/unionai/unionai-docs/blob/main/content/user-guide/getting-started/_index.md
**HTML**: https://www.union.ai/docs/v1/union/user-guide/getting-started/