Try Flyte 2 locally with the devbox
Get started
Flyte OSS Docs
Union.ai
Flyte OSS
v2
LATEST
v2
LATEST
v1
Search
⌘
K
Ask AI
⇧
⌘
K
Signup
User guide
Tutorials
Reference
Integrations
Platform deployment
Community
Flyte OSS Docs
User guide
Overview
Quickstart
Core concepts
TaskEnvironment
Tasks
Runs and actions
Where your data lives
Apps
Projects and domains
Key capabilities
Basic project
Run modes
Run locally in Python
Run locally on the devbox
Run on a remote cluster
Configure tasks
Container images
Resources
Secrets
Caching
Reusable containers
Pod templates
Multiple environments
Retries and timeouts
Triggers
Interruptible tasks
Task plugins
Additional task settings
Logging
Build tasks
Files and directories
Data classes and structures
DataFrames
Custom types
Custom context
Abort and cancel actions
Raw Container Tasks
Links
Reports
Notebooks
Remote tasks
Error handling
Traces
Intra-task checkpoints
Grouping actions
Fanout
Mapping over inputs
Controlling parallel execution
Streaming map-reduce
Structured concurrency with anyio
Task dependencies and ordering
External conditions
Unit Testing Tasks
Other features
Run and deploy tasks
How task run works
Interact with runs and actions
View logs
Work with local data
Run command options
How task deployment works
Deploy command options
Packaging
Deployment patterns
Run context
Entrypoint tasks
Run a Python script
Run with notifications
Re-run a run
Configure apps
App environments
Including additional files
Passing parameters into app environments
Autoscaling apps
Apps depending on other environments
Build apps
Single-script apps
Multi-script apps
Serving graphs
Hybrid app-task graphs
WebSocket apps
Browser apps
Secret-based authentication
Native app integrations
Streamlit app
FastAPI app
vLLM app
SGLang app
Flyte webhook
Serve and deploy apps
How app serving works
How app custom domains work
How app deployment works
Activating and deactivating apps
Prefetching models
Build an agent
Pure Python agents
Flyte-native agents
Agent memory
Agent chat UI
Deploy an agent as a service
Agent framework integrations
LangGraph agents
PydanticAI agents
OpenAI agents
Bring your own framework
Build an MCP
User-defined MCP server
Flyte MCP server
Sandboxing
Workflow sandboxing
Programmatic tool calling for agents
Code sandboxing
Project patterns
Bring your own image (BYOI)
Monorepo with uv
CI/CD deployments
Scale your runs
Data flow
Life of a run
Scale your workflows
Batch inference
Advanced project
Resilient generation
Agentic refinement
Parallel outputs
Serving app
Migration
From Flyte 1 to 2
Pure Python
Asynchronous model
Migration
Considerations
From Airflow to Flyte
Part 1: vanilla operators
Tutorials
Biotech & healthcare
Genomic alignment
Brain tumor MRI classification
Cross-species gene comparison
Genomic variant effect prediction
Drug molecule screening agent
Geospatial
GPU-accelerated climate modeling
Financial services & fintech
Multi-agent trading simulation
Fraud detection with Feast
Financial research agent
Frontier AI
Distributed LLM pretraining
Computer vision
Fine-tuning a VLM
Multimodal retrieval evaluation
RT-DETR object detection
Agents
Autoresearch agent
Parallelized autoresearch agent
AutoSec researcher agent
Coding agent
Competitive intelligence agent
Deep research
LangGraph research agent
MLE bot
Compliance monitoring agent
Field data enrichment agent
Support resolution agent
Code mode analytics agent
Context engineering
Text-to-SQL prompt optimization
Automatic prompt engineering
Model training
LLM fine-tuning with LoRA and QLoRA
BERT emotion classification
Hyperparameter optimization
Reference
LLM-optimized documentation
Migration from Flyte 1
Philosophy and imports
Container images
Configuration and CLI
Tasks and workflows
Secrets, resources, and caching
Parallelism and async
Triggers and dynamic workflows
Examples and common gotchas
Flyte CLI
Flyte SDK
Classes & Protocols
Packages
flyte
AppHandle
Backoff
BaseCheckpoint
Cache
CachePolicy
Checkpoint
ConditionWebhook
Cron
Device
Environment
FixedRate
Image
ImageBuild
Link
PodTemplate
Resources
RetryStrategy
ReusePolicy
Secret
TaskEnvironment
Timeout
Trigger
flyte.ai.agents
AccessDenied
Agent
AgentEvent
AgentProtocol
AgentResult
AgentTool
ConcurrencyError
LLMMessage
MCPServerSpec
MemoryMeta
MemoryStore
MemoryStoreError
ToolFn
flyte.ai.agents.agent
Agent
AgentEvent
flyte.ai.agents.memory
AccessDenied
ConcurrencyError
MemoryMeta
MemoryStore
MemoryStoreError
flyte.ai.agents.protocol
AgentProtocol
AgentResult
flyte.ai.chat
AgentChatAppEnvironment
CustomTheme
flyte.ai.chat.app
AgentChatAppEnvironment
CustomTheme
flyte.ai.mcp
FlyteMCPAppEnvironment
MCPAppEnvironment
flyte.app
AppEndpoint
AppEnvironment
ConnectorEnvironment
Domain
Link
Parameter
Port
RunOutput
Scaling
Timeouts
flyte.app.extras
FastAPIAppEnvironment
FastAPIPassthroughAuthMiddleware
FlyteWebhookAppEnvironment
flyte.clustered
ClusteredTaskEnvironment
ClusteredTaskTemplate
ClusterFailurePolicy
TorchRun
flyte.config
Config
flyte.connectors
AsyncConnector
AsyncConnectorExecutorMixin
ConnectorRegistry
ConnectorService
Resource
ResourceMeta
flyte.connectors.utils
flyte.durable
flyte.errors
ActionAbortedError
ActionNotFoundError
BaseRuntimeError
CodeBundleError
ConditionAlreadyExistsError
ConditionFailedError
ConditionNotFoundError
ConditionTimedoutError
CustomError
DeploymentError
ImageBuildError
ImagePullBackOffError
InitializationError
InlineIOMaxBytesBreached
InvalidImageNameError
InvalidPackageError
LogsNotYetAvailableError
ModuleLoadError
NonRecoverableError
NotInTaskContextError
OnlyAsyncIOSupportedError
OOMError
ParameterMaterializationError
PrimaryContainerNotFoundError
RemoteTaskNotFoundError
RemoteTaskUsageError
RestrictedTypeError
RetriesExhaustedError
RuntimeDataValidationError
RuntimeSystemError
RuntimeUnknownError
RuntimeUserError
SlowDownError
TaskInterruptedError
TaskTimeoutError
TraceDoesNotAllowNestedTasksError
UnionRpcError
flyte.extend
AsyncFunctionTaskTemplate
ImageBuildEngine
ImageBuilder
ImageChecker
TaskTemplate
flyte.extras
BatchStats
ContainerTask
CostEstimator
DynamicBatcher
Prompt
Sleep
SleepTask
TokenBatcher
TokenEstimator
flyte.extras.shell
FlagSpec
Glob
Stderr
Stdout
flyte.git
GitStatus
flyte.io
DataFrame
Dir
EmptyDir
File
HashFunction
flyte.io.extend
DataFrameDecoder
DataFrameEncoder
DataFrameTransformerEngine
flyte.models
ActionID
ActionPhase
CheckpointPaths
CodeBundle
GroupData
NativeInterface
PathRewrite
RawDataPath
SerializationContext
TaskContext
flyte.notify
Email
NamedDelivery
NamedRule
Notification
Slack
Teams
Webhook
flyte.prefetch
HuggingFaceModelInfo
ShardConfig
StoredModelInfo
VLLMShardArgs
flyte.remote
Action
ActionDetails
ActionInputs
ActionOutputs
App
Condition
Project
Run
RunDetails
Secret
Settings
Task
TaskDetails
TimeFilter
Trigger
User
flyte.report
Report
Timeline
flyte.sandbox
CodeTaskTemplate
ImageConfig
SandboxedConfig
SandboxedTaskTemplate
flyte.storage
ABFS
GCS
S3
Storage
flyte.syncify
Syncify
flyte.types
FlytePickle
Renderable
TypeEngine
TypeTransformer
TypeTransformerFailedError
Union plugin
flyteplugins.union
Integrations
Anthropic
Classes
Packages
flyteplugins.anthropic
Agent
BigQuery
Classes
Packages
flyteplugins.bigquery
BigQueryConfig
BigQueryConnector
BigQueryTask
Code generation
Classes
Packages
flyteplugins.codegen
AutoCoderAgent
CodeGenEvalResult
CodePlan
CodeSolution
ErrorDiagnosis
ImageConfig
Dask
Classes
Packages
flyteplugins.dask
Dask
Scheduler
WorkerGroup
Databricks
Classes
Packages
flyteplugins.databricks
Databricks
DatabricksConnector
Gemini
Classes
Packages
flyteplugins.gemini
Agent
Hydra
flyteplugins.hydra
JSONL
Classes
Packages
flyteplugins.jsonl
JsonlDir
JsonlFile
MLflow
Classes
Packages
flyteplugins.mlflow
Mlflow
OmegaConf
flyteplugins.omegaconf
OpenAI
flyteplugins.openai.agents
Papermill
Classes
Packages
flyteplugins.papermill
NotebookTask
Polars
Classes
Packages
flyteplugins.polars.df_transformer
ParquetToPolarsDecodingHandler
ParquetToPolarsLazyFrameDecodingHandler
PolarsLazyFrameToParquetEncodingHandler
PolarsToParquetEncodingHandler
PyTorch
Classes
Packages
flyteplugins.pytorch
Elastic
Ray
Classes
Packages
flyteplugins.ray
HeadNodeConfig
RayJobConfig
WorkerNodeConfig
SGLang
Classes
Packages
flyteplugins.sglang
SGLangAppEnvironment
Snowflake
Classes
Packages
flyteplugins.snowflake
Snowflake
SnowflakeConfig
SnowflakeConnector
Spark
Classes
Packages
flyteplugins.spark
ParquetToSparkDecoder
Spark
SparkToParquetEncoder
vLLM
Classes
Packages
flyteplugins.vllm
VLLMAppEnvironment
Weights & Biases
Classes
Packages
flyteplugins.wandb
Wandb
WandbSweep
Integrations
Anthropic
BigQuery
Code generation
Dask
Databricks
Gemini
Hydra
JSONL
MLflow
OmegaConf
OpenAI
Agent tools
OpenTelemetry
Pandera
Papermill
Polars
PyTorch
Ray
Snowflake
Spark
Weights & Biases
Experiments
Distributed training
Sweeps
Downloading logs
Constraints and best practices
Manual integration
Platform deployment
Deployment overview
Kind deployment
Set up local OIDC provider
Set up external OIDC provider
AWS deployment
Authentication and SSO
Enable app serving
Community
Joining the community
Contributing code
Contributing docs and examples
Quick start
Variants
Versions
Authoring
Shortcodes
Redirects
API docs
LLM-optimized documentation
Publishing
Documentation navigation for Flyte including user guides, tutorials, API references, and integration examples
LLM-optimized documentation
Migration from Flyte 1
Philosophy and imports
Container images
Configuration and CLI
Tasks and workflows
Secrets, resources, and caching
Parallelism and async
Triggers and dynamic workflows
Examples and common gotchas
Flyte CLI
Flyte SDK
Classes & Protocols
Packages
flyte
AppHandle
Backoff
BaseCheckpoint
Cache
CachePolicy
Checkpoint
ConditionWebhook
Cron
Device
Environment
FixedRate
Image
ImageBuild
Link
PodTemplate
Resources
RetryStrategy
ReusePolicy
Secret
TaskEnvironment
Timeout
Trigger
flyte.ai.agents
AccessDenied
Agent
AgentEvent
AgentProtocol
AgentResult
AgentTool
ConcurrencyError
LLMMessage
MCPServerSpec
MemoryMeta
MemoryStore
MemoryStoreError
ToolFn
flyte.ai.agents.agent
Agent
AgentEvent
flyte.ai.agents.memory
AccessDenied
ConcurrencyError
MemoryMeta
MemoryStore
MemoryStoreError
flyte.ai.agents.protocol
AgentProtocol
AgentResult
flyte.ai.chat
AgentChatAppEnvironment
CustomTheme
flyte.ai.chat.app
AgentChatAppEnvironment
CustomTheme
flyte.ai.mcp
FlyteMCPAppEnvironment
MCPAppEnvironment
flyte.app
AppEndpoint
AppEnvironment
ConnectorEnvironment
Domain
Link
Parameter
Port
RunOutput
Scaling
Timeouts
flyte.app.extras
FastAPIAppEnvironment
FastAPIPassthroughAuthMiddleware
FlyteWebhookAppEnvironment
flyte.clustered
ClusteredTaskEnvironment
ClusteredTaskTemplate
ClusterFailurePolicy
TorchRun
flyte.config
Config
flyte.connectors
AsyncConnector
AsyncConnectorExecutorMixin
ConnectorRegistry
ConnectorService
Resource
ResourceMeta
flyte.connectors.utils
flyte.durable
flyte.errors
ActionAbortedError
ActionNotFoundError
BaseRuntimeError
CodeBundleError
ConditionAlreadyExistsError
ConditionFailedError
ConditionNotFoundError
ConditionTimedoutError
CustomError
DeploymentError
ImageBuildError
ImagePullBackOffError
InitializationError
InlineIOMaxBytesBreached
InvalidImageNameError
InvalidPackageError
LogsNotYetAvailableError
ModuleLoadError
NonRecoverableError
NotInTaskContextError
OnlyAsyncIOSupportedError
OOMError
ParameterMaterializationError
PrimaryContainerNotFoundError
RemoteTaskNotFoundError
RemoteTaskUsageError
RestrictedTypeError
RetriesExhaustedError
RuntimeDataValidationError
RuntimeSystemError
RuntimeUnknownError
RuntimeUserError
SlowDownError
TaskInterruptedError
TaskTimeoutError
TraceDoesNotAllowNestedTasksError
UnionRpcError
flyte.extend
AsyncFunctionTaskTemplate
ImageBuildEngine
ImageBuilder
ImageChecker
TaskTemplate
flyte.extras
BatchStats
ContainerTask
CostEstimator
DynamicBatcher
Prompt
Sleep
SleepTask
TokenBatcher
TokenEstimator
flyte.extras.shell
FlagSpec
Glob
Stderr
Stdout
flyte.git
GitStatus
flyte.io
DataFrame
Dir
EmptyDir
File
HashFunction
flyte.io.extend
DataFrameDecoder
DataFrameEncoder
DataFrameTransformerEngine
flyte.models
ActionID
ActionPhase
CheckpointPaths
CodeBundle
GroupData
NativeInterface
PathRewrite
RawDataPath
SerializationContext
TaskContext
flyte.notify
Email
NamedDelivery
NamedRule
Notification
Slack
Teams
Webhook
flyte.prefetch
HuggingFaceModelInfo
ShardConfig
StoredModelInfo
VLLMShardArgs
flyte.remote
Action
ActionDetails
ActionInputs
ActionOutputs
App
Condition
Project
Run
RunDetails
Secret
Settings
Task
TaskDetails
TimeFilter
Trigger
User
flyte.report
Report
Timeline
flyte.sandbox
CodeTaskTemplate
ImageConfig
SandboxedConfig
SandboxedTaskTemplate
flyte.storage
ABFS
GCS
S3
Storage
flyte.syncify
Syncify
flyte.types
FlytePickle
Renderable
TypeEngine
TypeTransformer
TypeTransformerFailedError
Union plugin
flyteplugins.union
Integrations
Anthropic
Classes
Packages
flyteplugins.anthropic
Agent
BigQuery
Classes
Packages
flyteplugins.bigquery
BigQueryConfig
BigQueryConnector
BigQueryTask
Code generation
Classes
Packages
flyteplugins.codegen
AutoCoderAgent
CodeGenEvalResult
CodePlan
CodeSolution
ErrorDiagnosis
ImageConfig
Dask
Classes
Packages
flyteplugins.dask
Dask
Scheduler
WorkerGroup
Databricks
Classes
Packages
flyteplugins.databricks
Databricks
DatabricksConnector
Gemini
Classes
Packages
flyteplugins.gemini
Agent
Hydra
flyteplugins.hydra
JSONL
Classes
Packages
flyteplugins.jsonl
JsonlDir
JsonlFile
MLflow
Classes
Packages
flyteplugins.mlflow
Mlflow
OmegaConf
flyteplugins.omegaconf
OpenAI
flyteplugins.openai.agents
Papermill
Classes
Packages
flyteplugins.papermill
NotebookTask
Polars
Classes
Packages
flyteplugins.polars.df_transformer
ParquetToPolarsDecodingHandler
ParquetToPolarsLazyFrameDecodingHandler
PolarsLazyFrameToParquetEncodingHandler
PolarsToParquetEncodingHandler
PyTorch
Classes
Packages
flyteplugins.pytorch
Elastic
Ray
Classes
Packages
flyteplugins.ray
HeadNodeConfig
RayJobConfig
WorkerNodeConfig
SGLang
Classes
Packages
flyteplugins.sglang
SGLangAppEnvironment
Snowflake
Classes
Packages
flyteplugins.snowflake
Snowflake
SnowflakeConfig
SnowflakeConnector
Spark
Classes
Packages
flyteplugins.spark
ParquetToSparkDecoder
Spark
SparkToParquetEncoder
vLLM
Classes
Packages
flyteplugins.vllm
VLLMAppEnvironment
Weights & Biases
Classes
Packages
flyteplugins.wandb
Wandb
WandbSweep
Flyte 2 Devbox
is available today to run a full Flyte backend and UI locally.
Preview Flyte 2 for production
, hosted on
Union.ai
Flyte OSS
Reference
Flyte SDK
Packages
flyte.types
TypeTransformerFailedError
2.5.9
TypeTransformerFailedError
Package:
flyte.types
LLM-optimized
This page
Full docs index
On this page
404
Page not found
Showing closest match
