# Union.ai BYOC

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 BYOC (Bring Your Own Cloud) provides all the features of Flyte, plus much more
in an environment where you keep your data and workflow code on your infrastructure, while Union.ai takes care of the management.

> [!NOTE]
> These are the Union.ai **2.0** docs.
> To switch to [version 1.0](https://www.union.ai/docs/v1/byoc/) 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/byoc/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/byoc/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/byoc/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/byoc/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/byoc/user-guide/core-concepts/page.md)
  - How Flyte works
- [Running locally](https://www.union.ai/docs/v2/byoc/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/byoc/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/byoc/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/byoc/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/byoc/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/byoc/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/byoc/user-guide/task-configuration/page.md)
  - Task configuration levels
  - Example
  - Parameter interaction
  - Task configuration parameters
- [Build tasks](https://www.union.ai/docs/v2/byoc/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/byoc/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/byoc/user-guide/run-scaling/page.md)
  - Understanding Flyte execution
  - Performance optimization
  - Key concepts for scaling
- [Configure apps](https://www.union.ai/docs/v2/byoc/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/byoc/user-guide/build-apps/page.md)
  - App types
  - Next steps
- [Serve and deploy apps](https://www.union.ai/docs/v2/byoc/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/byoc/user-guide/build-agent/page.md)
  - Quickstart
  - Next steps
- [Sandboxing](https://www.union.ai/docs/v2/byoc/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/byoc/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/byoc/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/byoc/user-guide/