# Union.ai

Union.ai empowers AI development teams to rapidly ship high-quality code to production by offering optimized performance, unparalleled resource efficiency, and a delightful workflow authoring experience. With Union.ai your team can:

* Run complex AI workloads with performance, scale, and efficiency.
* Achieve millisecond-level execution times with reusable containers.
* Scale out to multiple regions, clusters, and clouds as needed for resource availability, scale, or compliance.

Union.ai is built on top of the leading open-source workflow orchestrator, [Flyte](https://www.union.ai/docs/v2/flyte/).

Union.ai provides all the features of Flyte, plus much more, in an environment where you keep your data and workflow code on your own infrastructure. Union.ai is available as [BYOC](https://www.union.ai/docs/v2/union//deployment/byoc/_index) (Bring Your Own Cloud), where Union.ai manages the infrastructure for you, or [Self-managed](https://www.union.ai/docs/v2/union//deployment/selfmanaged/_index), where you manage the data plane yourself.

> [!NOTE]
> These are the Union.ai **2.0** docs.
> To switch to [version 1.0](https://www.union.ai/docs/v1/union/) or to another product variant, use the selectors above.

> **📝 Note**
>
> Want to try Flyte without installing anything? [Try Flyte 2 in your browser](https://flyte2intro.apps.demo.hosted.unionai.cloud/).

### [Flyte 2](https://www.union.ai/docs/v2/union/user-guide/flyte-2/page.md)

Flyte 2 represents a fundamental shift in how AI workflows are written and executed. Learn
more in this section.

### [Quickstart](https://www.union.ai/docs/v2/union/user-guide/quickstart/page.md)

Install Flyte 2, configure your local IDE, create and run your first task, and inspect the results in 2 minutes.

## Subpages

- [Overview](https://www.union.ai/docs/v2/union/user-guide/overview/page.md)
  - Pure Python, no DSL
  - Durability
  - Reproducibility
  - Recoverability
  - Built for scale
  - What this means in practice
- [Quickstart](https://www.union.ai/docs/v2/union/user-guide/quickstart/page.md)
  - What you'll need
  - Install the SDK
  - Configure
  - Write your first workflow
  - Run it
  - See the results
  - Next steps
- [Core concepts](https://www.union.ai/docs/v2/union/user-guide/core-concepts/page.md)
  - How Flyte works
- [Running locally](https://www.union.ai/docs/v2/union/user-guide/running-locally/page.md)
  - Getting started
  - Running tasks locally
  - Terminal UI
  - Exploring past runs
  - What works locally
  - Local to remote
  - Next steps
- [Connecting to a cluster](https://www.union.ai/docs/v2/union/user-guide/connecting-to-a-cluster/page.md)
  - Prerequisites
  - Install the flyte package
  - Configuration file
  - Using the configuration
  - Explicit configuration
  - Programmatic
  - CLI
  - Programmatic
  - CLI
  - Check current configuration
  - Inline configuration
  - Programmatic
  - CLI
  - Next steps
- [Projects and domains](https://www.union.ai/docs/v2/union/user-guide/projects-and-domains/page.md)
  - How projects and domains are used
  - Managing projects via CLI
  - Create a project
  - List projects
  - Update a project
  - Archive a project
  - Unarchive a project
  - Listing projects programmatically
  - Managing projects via the UI
  - Domains
  - Targeting a domain
- [Basic project](https://www.union.ai/docs/v2/union/user-guide/basic-project/page.md)
  - Concepts covered
  - Part 1: The embedding pipeline
  - Setting up the environment
  - Fetching data
  - Creating embeddings
  - Orchestrating the pipeline
  - Running the pipeline
  - Part 2: The serving application
  - App environment configuration
  - The Streamlit application
  - Deploying the app
  - Key takeaways
- [Advanced project](https://www.union.ai/docs/v2/union/user-guide/advanced-project/page.md)
  - What you'll build
  - Concepts covered
  - Architecture
  - Prerequisites
  - Parts
  - Key takeaways
- [From Flyte 1 to 2](https://www.union.ai/docs/v2/union/user-guide/flyte-2/page.md)
  - Pure Python execution
  - Sync Python
  - Async Python
  - Simplified API
  - Fine-grained reproducibility and recoverability
  - Improved remote functionality
  - Native Notebook support
  - High performance engine
  - Enhanced UI
- [Configure tasks](https://www.union.ai/docs/v2/union/user-guide/task-configuration/page.md)
  - Task configuration levels
  - Example
  - Parameter interaction
  - Task configuration parameters
- [Build tasks](https://www.union.ai/docs/v2/union/user-guide/task-programming/page.md)
  - What you'll learn
  - When to use these patterns
- [Run and deploy tasks](https://www.union.ai/docs/v2/union/user-guide/task-deployment/page.md)
  - Ephemeral deployment and immediate execution
  - Programmatic
  - CLI
  - Persistent deployment
  - Programmatic
  - CLI
  - Running already deployed tasks
  - Programmatic
  - CLI
  - Configuring runs with `flyte.with_runcontext()`
- [Scale your runs](https://www.union.ai/docs/v2/union/user-guide/run-scaling/page.md)
  - Understanding Flyte execution
  - Performance optimization
  - Key concepts for scaling
- [Configure apps](https://www.union.ai/docs/v2/union/user-guide/configure-apps/page.md)
  - Hello World example
  - Using fserve args
  - Using @app_env.server
  - Differences from TaskEnvironment
  - Configuration topics
- [Build apps](https://www.union.ai/docs/v2/union/user-guide/build-apps/page.md)
  - App types
  - Next steps
- [Serve and deploy apps](https://www.union.ai/docs/v2/union/user-guide/serve-and-deploy-apps/page.md)
  - Serve vs Deploy
  - `flyte serve`
  - `flyte deploy`
  - Using Python SDK
  - Serve
  - Deploy
  - Using the CLI
  - Serve
  - Deploy
  - Next steps
- [Build an agent](https://www.union.ai/docs/v2/union/user-guide/build-agent/page.md)
  - Quickstart
  - Next steps
- [Sandboxing](https://www.union.ai/docs/v2/union/user-guide/sandboxing/page.md)
  - Why sandboxing matters for AI
  - Types of sandboxes
  - What Flyte offers
  - Workflow sandbox (Monty)
  - Code sandbox (container)
  - When to use which
  - Learn more
- [Authenticating](https://www.union.ai/docs/v2/union/user-guide/authenticating/page.md)
  - Quick start
  - Programmatic
  - CLI
  - Authentication modes
  - PKCE authentication (browser-based) {#pkce}
  - Programmatic
  - CLI
  - Device flow authentication {#device-flow}
  - Programmatic
  - CLI
  - API key authentication (OAuth2 app credentials) {#api-key}
  - Programmatic
  - CLI
  - Comparison table
  - Switching between authentication modes
  - Token storage and keyring {#token-storage}
  - How it works
  - Systems without keyring support
  - Solution: Install keyrings.alt
  - Verifying keyring functionality
  - Troubleshooting
  - Browser doesn't open for PKCE
  - Device flow code expires
  - API key doesn't work
  - Best practices
- [User management](https://www.union.ai/docs/v2/union/user-guide/user-management/page.md)
  - Built-in policies
  - Custom roles and policies
  - Prerequisites
  - Walkthrough: restrict a team to run workflows in production only
  - Programmatic
  - CLI
  - Updating roles and policies
  - Programmatic
  - CLI
  - Managing users in the UI
  - Available actions
  - CLI command reference

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