# Fused Documentation
> Fused is an end-to-end cloud platform for data analytics, built around User Defined Functions (UDFs): Python functions that can be run via HTTPS requests from anywhere, without any install required.
## Guide
- [What is Fused?](https://docs.fused.io/guide/guide-overview) - Fused is the glue between your data and the tools that consume it: write Python functions that run serverlessly at scale, and expose them as secure HT...
- [Dependencies](https://docs.fused.io/guide/advanced-setup/dependencies) - To keep things simple, Fused maintains a single runtime image. This means that any UDF you run will be executed with these dependencies by default...
- [Secrets management](https://docs.fused.io/guide/advanced-setup/secrets-management) - Fused provides a built-in secrets manager to securely store and access sensitive credentials like API keys, database passwords, and tokens. Both types...
- [Git Integration](https://docs.fused.io/guide/advanced-setup/git-integration) - Github integration allows you to:...
- [Python installation](https://docs.fused.io/guide/advanced-setup/local-installation) - Install and authenticate the Fused Python SDK locally
- [On-Prem Setup](https://docs.fused.io/guide/advanced-setup/on-prem-setup) - Deploy Fused inside your own AWS account for full data sovereignty, unlimited compute, and seamless integration with existing infrastructure.
- [Audit Logs](https://docs.fused.io/guide/data-input-outputs/export-api/audit-logs) - `fused.api.log()` retrieves audit logs for UDF executions. Every time a UDF runs, the system records metadata about the execution including which UDF ...
- [Download](https://docs.fused.io/guide/data-input-outputs/export-api/download) - Download remote files to the local system to make them available to UDFs across runs. Files are written to a disk shared across all UDFs in an organiz...
- [Geospatial Export](https://docs.fused.io/guide/data-input-outputs/export-api/geospatial-export) - Integrate Fused UDFs with popular mapping and visualization tools. See UDFs as API for more details....
- [Securing Shared Tokens](https://docs.fused.io/guide/data-input-outputs/export-api/securing-shared-tokens) - Fused shared tokens can be set to either **public** or **team-only** access. You should set the token access depending on your use case, and the sensi...
- [Tokens & endpoints](https://docs.fused.io/guide/data-input-outputs/export-api/tokens-endpoints) - width: "100%",...
- [Connecting the AI to data](https://docs.fused.io/guide/data-input-outputs/import-connection/ai-data-connection) - User Defined Tools let you use UDFs as tools to provide the AI with extra context about your data. This enables the AI to query your databases, search...
- [Cloud storage](https://docs.fused.io/guide/data-input-outputs/import-connection/cloud-storage) - Fused supports multiple cloud storage options for reading and writing data....
- [Databases](https://docs.fused.io/guide/data-input-outputs/import-connection/databases) - Connect Fused to external databases. See the dedicated integration guides:...
- [Google Earth Engine](https://docs.fused.io/guide/data-input-outputs/import-connection/geospatial/gee) - Fused interfaces Google Earth Engine with the Python `earthengine-api` library. This example shows how to load data from GEE datasets into Fused UDFs ...
- [STAC Catalogs](https://docs.fused.io/guide/data-input-outputs/import-connection/geospatial/stac) - Access STAC (SpatioTemporal Asset Catalog) catalogs with pystac and odc.stac....
- [Local files](https://docs.fused.io/guide/data-input-outputs/import-connection/local-files) - Quickly bring any local data into Fused....
- [Using AI inside a UDF](https://docs.fused.io/guide/data-input-outputs/import-connection/using-ai-inside-udf) - You can call large language models directly from inside a UDF with `job2.ai`. No API keys or token management — Fused handles authentication through y...
- [Widgets](https://docs.fused.io/guide/data-input-outputs/import-connection/widgets) - ...
- [Geospatial Ingestion](https://docs.fused.io/guide/data-input-outputs/read-write/geospatial/ingestion) - _This page gives you tools to make your data fast to read so your UDFs are more responsive._...
- [Reading geospatial](https://docs.fused.io/guide/data-input-outputs/read-write/geospatial/geospatial-reading) - Common examples for reading geospatial data in Fused....
- [Writing geospatial](https://docs.fused.io/guide/data-input-outputs/read-write/geospatial/geospatial-writing) - When working with geospatial data in Fused we recommend saving files in these formats:...
- [Reading files](https://docs.fused.io/guide/data-input-outputs/read-write/reading) - Common examples for reading tabular data in Fused....
- [Writing files](https://docs.fused.io/guide/data-input-outputs/read-write/writing) - Common examples for writing tabular data in Fused....
- [First UDF & basics](https://docs.fused.io/guide/getting-started/first-udf-basics) - Fused makes it easy to run Python at scale. You write Python code, and Fused handles execution, scaling, and API generation automatically....
- [Using AI](https://docs.fused.io/guide/getting-started/using-ai) - AI is built into Workbench to help you write, edit, and debug UDFs. There are 2 main ways to use AI in Fused:...
- [Workbench intro](https://docs.fused.io/guide/getting-started/workbench-intro) - Workbench is Fused's browser based IDE. ...
- [Aggregations](https://docs.fused.io/guide/h3-analytics/aggregations) - After ingesting a dataset to H3 hexagons it's possible to visualize it in Fused but we can also directly work with the data....
- [Converting to H3](https://docs.fused.io/guide/h3-analytics/converting) - This page covers different methods to convert your data into H3 hexagons....
- [Joining](https://docs.fused.io/guide/h3-analytics/joining) - This page shows how to join two H3 hexagon datasets. This allows merging different datasets together to simplify analysis as each cell contains all th...
- [H3 Analytics Overview](https://docs.fused.io/guide/h3-analytics/h3-overview) - Consider using H3 tiling when:...
- [Resolution Guide](https://docs.fused.io/guide/h3-analytics/resolution-guide) - Cheat sheet for choosing the right H3 resolution....
- [Visualization](https://docs.fused.io/guide/h3-analytics/visualization) - Quick styling options for H3 data in Workbench:...
- [UDFs as API](https://docs.fused.io/guide/working-with-udfs/run-udfs-as-api) - Every UDF can be used as a file system....
- [Parallel execution](https://docs.fused.io/guide/working-with-udfs/fused-submit) - Run a UDF over multiple inputs in parallel....
- [Running UDFs](https://docs.fused.io/guide/working-with-udfs/fused-run) - Run a UDF and get results back....
- [Scheduling UDFs](https://docs.fused.io/guide/working-with-udfs/scheduling-udfs) - Schedule UDFs to run automatically on a recurring cron schedule. Scheduled UDFs execute on batch compute instances with no time limit, making them sui...
- [Building UDFs for Agents](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/agents) - Fused gives you a uniquely fast path from data to agent tool. Write a Python function that joins datasets from any source — FTP servers, one-time CSV ...
- [Scaling Out UDFs](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/scaling-out) - When realtime isn't enough: run many jobs in parallel, or run on a dedicated machine with more resources....
- [Efficient caching](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/caching) - Fused caches UDF results automatically to make repeated calls faster. Cached calls return instantly and **don't consume Fused Credit Units**—you only ...
- [Debugging playbook](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/debugging-playbook) - Practical techniques for diagnosing and fixing UDFs — from slow code to failed parallel jobs....
- [Geospatial processing](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/geospatial-single-vs-tile) - There are 2 main ways to work with spatial data in Fused:...
- [Run UDFs efficiently](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/realtime) - Realtime is the default way to run UDFs—no configuration needed. Every UDF runs in realtime mode unless you explicitly request a batch instance....
- [Write UDFs securely](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/security) - Fused UDFs are flexible, but callers and shared links should be treated with the same care as any public API. The sections below cover secrets, parame...
- [Storage options](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/storage) - Fused provides two file systems to make files accessible to all UDFs: an S3-backed home directory and a disk. Access is scoped at the organization lev...
- [Un-pythonic aspects of Fused](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/unpythonic) - Fused UDFs look like Python functions but run in a managed, distributed environment. That environment imposes a few constraints that feel unusual if y...
- [Working as a team](https://docs.fused.io/guide/working-with-udfs/udf-best-practices/version-control) - Developer, Professional and Enterprise...
- [Why Fused](https://docs.fused.io/guide/working-with-udfs/why-fused) - At Fused, our mission is to help get things done, fast. We want every team to be able to get from **Analytics to Action** as quickly as they can. ...
- [Writing UDFs](https://docs.fused.io/guide/working-with-udfs/writing-udfs) - Follow these steps to write a User Defined Function (UDF)....
## Quickstart
- [Data Analytics](https://docs.fused.io/quickstart/data-analytics) - Quick links for data analysts using Fused....
- [Data Engineering](https://docs.fused.io/quickstart/data-engineering) - Quick links for data engineers using Fused....
- [Data Science](https://docs.fused.io/quickstart/data-science) - Quick links for data scientists using Fused....
- [Geospatial](https://docs.fused.io/quickstart/geospatial-cheatsheet) - Quick links for geospatial workflows in Fused....
## Examples
- [Letting Anyone Explore Airbnb on the Fly](https://docs.fused.io/examples/airbnb-explore-on-the-fly) - This example shows how to load, visualize, and interactively explore Airbnb listing data from San Francisco — roughly 7,000 points covering locations,...
- [AIS Dark Vessel Detection](https://docs.fused.io/examples/ais-dark-vessels) - _A complete example show casing how to use Fused to ingest data into a geo-partitioned, cloud friendly format, process images & vectors and use UDFs t...
- [Create a branded text to image pipeline](https://docs.fused.io/examples/branded-text-to-image) - **Define your brand's visual style once and share it with your whole team — anyone can generate on-brand images from a text prompt without a design to...
- [Canvas Gallery](https://docs.fused.io/examples/canvas-gallery) - Explore example Fused Canvases for geospatial analysis and workflows.
- [Climate Dashboard](https://docs.fused.io/examples/climate-dashboard) - We're going to build an interactive dashboard of global temperature data, after processing 1TB of data in a few minutes!...
- [Run ComfyUI workflows in Fused](https://docs.fused.io/examples/comfyui-fused-workflows) - **Using Fused to cache, orchestrate & reuse pipelines on top of ComfyUI to make easily repeatable image generation workflows.**...
- [Creating Charts](https://docs.fused.io/examples/creating-charts) - Create interactive charts from any data with AI assistance....
- [Will You Be Late to Your Meetings?](https://docs.fused.io/examples/google-calendar-meetings) - This example shows how to connect Google Calendar to a Fused pipeline that calculates travel time between appointments and flags meetings you're likel...
- [Maxar Satellite Imagery](https://docs.fused.io/examples/maxar-satellite-imagery) - _A guide showing how to use Fused to get all of Maxar's Open Data from all the available STAC catalogs and explore the imagery_...
- [Join and Expose Messy Data to AI Agents](https://docs.fused.io/examples/messy-data-agents) - This example shows how to join data scattered across Snowflake, Google Sheets, and S3 into a single Fused pipeline, then expose the combined result to...
- [Making Overture Buildings Data Accessible to Agents](https://docs.fused.io/examples/overture-buildings-agents) - This example shows how to turn Fused UDF pipelines into agentic workflows: ask questions over massive datasets while compute stays behind the scenes a...
- [Querying Overture Maps Data with an AI Agent](https://docs.fused.io/examples/overture-maps-mcp-agent) - This example shows how to wrap Overture Maps Foundation open data as MCP tools on a Fused Canvas, so an AI agent can query buildings, places, and more...
- [PDF Scraping](https://docs.fused.io/examples/pdf-scraping) - This tutorial will show you how to:...
- [Points of Interest Site Selection](https://docs.fused.io/examples/poi-site-selection-dashboard) - This example builds an interactive site selection dashboard that answers: **"What amenities and income levels surround a given address within a certai...
- [RAG Any Docs with Fused](https://docs.fused.io/examples/rag-overture-docs) - **_TL;DR: With a few Fused UDFs you can turn any public docs site into a fully searchable RAG pipeline — connect data, process it, and expose it as an...
- [Realtime Filtering with DuckDB](https://docs.fused.io/examples/realtime-filtering-duckdb) - This tutorial will show you how to build a real time filtering visualization using DuckDB WASM:...
- [Seismic Hazard Mapping](https://docs.fused.io/examples/seismic-hazard-mapping) - _Cross-reference earthquake hazard with building density over Italy to find where the most buildings sit in the highest-risk zones._...
- [Sharing Canvas Dashboards](https://docs.fused.io/examples/sharing-canvas-dashboards) - Any Canvas can be turned into a shareable dashboard by clicking the "Share" button in the top right corner. Sharing also creates a **canvas token** (`...
- [Site Selection Analysis](https://docs.fused.io/examples/site-selection-analysis) - :::info Using AI prompts as a starting point...
- [Standalone HTML Maps](https://docs.fused.io/examples/standalone-html-maps) - In Fused Canvas you can create workflows by connecting UDFs together and visualizing them on a map....
- [Web Scraping](https://docs.fused.io/examples/web-scraping) - This tutorial demonstrates how to use Fused User Defined Functions (UDFs) to scrape web pages and extract structured data. We'll walk through building...
- [Zonal Stats](https://docs.fused.io/examples/zonal-stats) - _A step-by-step guide for data scientists._...
## Python SDK
- [Changelog](https://docs.fused.io/python-sdk/changelog) - **Widgets: new components and capabilities**...
- [API Reference](https://docs.fused.io/python-sdk/overview) - This is the API reference for the `fused` Python package, which allows you to build and run serverless data workflows....
- [fused.api](https://docs.fused.io/python-sdk/api-reference/api) - The following functions can be called directly from the `fused.api` module:...
- [@fused.cache](https://docs.fused.io/python-sdk/api-reference/fused-cache) - Decorator to cache the return value of a function....
- [fused.context](https://docs.fused.io/python-sdk/api-reference/fused-context) - Access runtime context information from within a UDF. These functions return information about the current execution environment....
- [fused.download](https://docs.fused.io/python-sdk/api-reference/fused-download) - May be called from multiple processes with the same inputs to get the same result....
- [fused.file_path](https://docs.fused.io/python-sdk/api-reference/fused-file-path) - Creates a directory in a predefined temporary directory....
- [fused.find_dataset](https://docs.fused.io/python-sdk/api-reference/fused-find-dataset) - Find the dataset that contains a specific location URL....
- [fused.get_chunk_from_table](https://docs.fused.io/python-sdk/api-reference/fused-get-chunk-from-table) - Returns a chunk from a table and chunk coordinates....
- [fused.get_chunks_metadata](https://docs.fused.io/python-sdk/api-reference/fused-get-chunks-metadata) - Returns a GeoDataFrame with each chunk in the table as a row....
- [fused.ingest_nongeospatial](https://docs.fused.io/python-sdk/api-reference/fused-ingest-nongeospatial) - Ingest a dataset into the Fused partitioned format....
- [fused.ingest](https://docs.fused.io/python-sdk/api-reference/fused-ingest) - Ingest a dataset into the Fused partitioned format....
- [fused.load_async](https://docs.fused.io/python-sdk/api-reference/fused-load-async) - Asynchronously load a UDF from various sources....
- [fused.load](https://docs.fused.io/python-sdk/api-reference/fused-load) - Loads a UDF from various sources including GitHub URLs and a Fused platform-specific identifier....
- [fused.register_dataset](https://docs.fused.io/python-sdk/api-reference/fused-register-dataset) - Register a dataset for indexed queries....
- [fused.run_async [Legacy]](https://docs.fused.io/python-sdk/api-reference/fused-run-async) - This function is deprecated and will be removed in a future version. Use `udf.map_async()` instead....
- [fused.run [Legacy]](https://docs.fused.io/python-sdk/api-reference/fused-run) - This function is deprecated and will be removed in a future version. Use `udf()` instead....
- [fused.secrets](https://docs.fused.io/python-sdk/api-reference/fused-secrets) - Access team secrets stored in the Fused backend. Team secrets are scoped to the execution environment and shared across your team or organization. Req...
- [fused.submit [Legacy]](https://docs.fused.io/python-sdk/api-reference/fused-submit) - This function is deprecated and will be removed in a future version. Use `udf.map()` instead....
- [fused.types](https://docs.fused.io/python-sdk/api-reference/fused-types) - Type annotations for UDF parameters. Use these to get proper type hints and enable Fused-specific behaviors....
- [@fused.udf](https://docs.fused.io/python-sdk/api-reference/fused-udf) - A decorator that transforms a function into a Fused UDF....
- [fused.user_secrets](https://docs.fused.io/python-sdk/api-reference/fused-user-secrets) - Access secrets that are private to you. User secrets are private to the authenticated user — they are not shared with your team. Requires a paid plan....
- [fused.h3](https://docs.fused.io/python-sdk/api-reference/h3) - The `fused.h3` module provides functions for working with H3-indexed datasets, including ingestion, reading, and metadata management....
- [JobPool (class)](https://docs.fused.io/python-sdk/api-reference/jobpool) - The `JobPool` class manages parallel job execution and result retrieval. It is returned by `udf.map()`....
- [fused.options](https://docs.fused.io/python-sdk/api-reference/options) - List global configuration options....
- [Udf (class)](https://docs.fused.io/python-sdk/api-reference/udf) - A user-defined function. The `Udf` class is the object returned when decorating a function with `@fused.udf`, or when loading a saved UDF with `fused....
## Workbench
- [AI Chat](https://docs.fused.io/workbench/ai-chat) - The AI Chat is a tool that allows you to use AI to help you code directly in the Workbench....
- [Canvas Catalog](https://docs.fused.io/workbench/canvas-catalog) - The Canvas Catalog is your central view to explore and manage all your UDF projects. Here you can:...
- [Canvas Checkpoints](https://docs.fused.io/workbench/canvas-checkpoints) - Canvas Checkpoints let you capture a snapshot of your Canvas at a point in time....
- [File Explorer](https://docs.fused.io/workbench/file-explorer) - The File Explorer provides a streamlined interface to browse, preview, and open files in cloud object storage and the mounted disk. Fused supports Ama...
- [Free Tier](https://docs.fused.io/workbench/free-tier) - Fused is accessible to anyone for free by simply creating an account! Head over to Workbench and sign up!...
- [Integrations & Secrets](https://docs.fused.io/workbench/integrations-secrets) - The Integrations & Secrets page is where you connect third-party services to Fused and store the keys your UDFs need at runtime....
- [Job logs](https://docs.fused.io/workbench/jobs) - The Job logs page displays all dedicated jobs executions, organised into: ...
- [Overview](https://docs.fused.io/workbench/overview) - Workbench is a browser-based platform to build with data. Write Python, visualize results instantly, and share your work....
- [Preferences](https://docs.fused.io/workbench/preferences) - Open Preferences from the Workbench profile menu (top-right) to configure your session....
- [Profile](https://docs.fused.io/workbench/profile) - The Profile page in Workbench lets you edit your username, view account information, monitor usage, and manage your S3 bucket policy. Navigate to it f...
- [UDF Explorer](https://docs.fused.io/workbench/udf-explorer) - The UDF Explorer offers a searchable collection of User Defined Functions (UDFs) that can be imported into the Map Builder for editing. It facilitates...
- [Versioning](https://docs.fused.io/workbench/versions) - Developer, Professional and Enterprise _Versioning with GitHub is accessible to organizations with a Fused Developer, Profe...
- [Adding a Map to your App](https://docs.fused.io/workbench/app-builder/app-map) - For many geospatial applications you will want to add a map to your Fused App, especially if your UDF returns a Map `Tile`....
- [App Builder](https://docs.fused.io/workbench/app-builder/app-builder) - Learn everything there is about Fused Apps...
- [App Builder Overview](https://docs.fused.io/workbench/app-builder/app-overview) - The App Builder is an IDE to transform User Defined Functions (UDFs) into interactive, shareable apps....
- [Airtable Integration](https://docs.fused.io/workbench/integrations/airtable) - Read and write Airtable records from Fused UDFs by connecting to your Airtable account in Fused....
- [BigQuery Integration](https://docs.fused.io/workbench/integrations/bigquery) - Fused integrates with Google BigQuery via the Python `google-cloud-bigquery` library. Authentication uses the shared Google Cloud service account stor...
- [Google Cloud Storage Integration](https://docs.fused.io/workbench/integrations/gcs) - Connect a GCS bucket to Fused to browse files in the File Explorer and access them from UDFs....
- [Notion Integration](https://docs.fused.io/workbench/integrations/notion) - Read and write Notion pages, comments, and users from Fused UDFs using OAuth-managed tokens. No API keys need to be hardcoded — Fused handles token re...
- [Amazon S3 Integration](https://docs.fused.io/workbench/integrations/s3) - Connect an S3 bucket to Fused to browse files in the File Explorer and access them from UDFs....
- [Slack](https://docs.fused.io/workbench/integrations/slack) - Let anyone in your team talk to your Canvas with a Slack Bot!...
- [Snowflake](https://docs.fused.io/workbench/integrations/snowflake) - Query data, browse metadata, read/write stages, and write DataFrames to tables in Snowflake -- all using Fused-managed OAuth tokens. No passwords or c...
- [Canvas](https://docs.fused.io/workbench/udf-builder/canvas) - A Canvas is a way for users to organize their UDFs into different projects. This allows you to use Workbench for completely different, unrelated proje...
- [Code Editor](https://docs.fused.io/workbench/udf-builder/code-editor) - The Code Editor is where developers write UDFs using standard Python libraries and installed dependencies. The Editor tab contain functionality to org...
- [Map](https://docs.fused.io/workbench/udf-builder/map) - As developers edit UDFs in the Code Editor and explore data, they can receive immediate visual feedback on how the code's transformations affect the d...
- [Navigation](https://docs.fused.io/workbench/udf-builder/navigation) - The Navigation pane on the left side of the Map Builder displays the UDFs available to the user. UDFs are listed as layers. Their order corresponds to...
- [Runtime](https://docs.fused.io/workbench/udf-builder/runtime) - Exploring and analyzing data involves scanning logs, previewing intermediary outputs, and debugging errors....
- [(Advanced) Map Builder](https://docs.fused.io/workbench/udf-builder/udf-builder) - The Map Builder is an IDE to write User Defined Functions (UDFs) and visualize their output....
- [Layer Styling](https://docs.fused.io/workbench/udf-builder/styling) - The Map builder displays data from your UDF on the map. You can customize the visual representation using the visualization icon located on the map....
## Quick Start
- [Installation & Setup](https://docs.fused.io/guide/getting-started/first-udf-basics) - Get started with Fused in minutes
---
Generated automatically from Fused documentation. Last updated: 2026-05-18