repowiseprefecthq/prefect

prefecthq / prefect

Prefect is a workflow orchestration framework for building resilient data pipelines in Python.

Python★ 23,976
Use in your agentAsk this codebase

github.com/prefecthq/prefectIndexed at b749a67Up to date with upstream

What is prefect?

prefect is a workflow orchestration framework for building resilient data pipelines in Python. It turns Python scripts into workflows that can use scheduling, caching, retries, dependencies, branching logic, and event-based automations. The repository uses Python for orchestration and includes TypeScript and JavaScript web interfaces.

Written by a model from the README and the source

4,839 files and 36,096 symbols in 14 modules, led by Python (1,863 files) and TypeScript (1,574).

Start reading

Code health

7.6out of 10Good

Hotspots average 3.9, the place fixes pay off most.

Full health report

On the leaderboards:#1 of 3 Workflow orchestrators#12 of 50 Python repos

Use prefecthq/prefect in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/prefecthq/prefect
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is prefect put together?")
  • get_why("why is prefect structured this way?")

Explore prefect

Key features of prefect

  • Prefect lets Python data pipelines use scheduling, caching, retries, and event-based automations.
  • Prefect workflows can handle retries, dependencies, and complex branching logic.
  • Prefect tracks workflow activity through a self-hosted server instance or Prefect Cloud dashboard.
  • Prefect deployments can run workflows on a schedule, manually from the UI or CLI, or in response to events.

How prefecthq/prefect works

Workflow definitions and runtime events enter through the Python server, CLI, and integration modules. The src directory defines typed API contracts, validators, type aliases, and REST payload schemas used by the orchestration layer. Server APIs and workers transform workflow activity into persisted flow runs, task runs, artifacts, logs, and events. The prefect logging modules provide logging infrastructure, while prefect exceptions defines project exceptions. The ui and ui-v2 directories provide web interfaces for monitoring and managing executions. REST endpoints and the web interfaces expose the resulting orchestration state.

The codebase has 4,839 files and 36,096 symbols in 14 modules, led by Python, TypeScript and Shell. Code health is 7.6 out of 10, rated good.

Getting started with prefect

  1. Install Prefect with pip.
    pip install -U prefect
  2. Install Prefect with uv.
    uv add prefect
  3. Start a local Prefect server.
    prefect server start

Commands copied from the README

prefecthq/prefect FAQ

What is prefect?

prefect is a Python workflow orchestration framework for building resilient data pipelines. It turns scripts into workflows with scheduling, retries, caching, and event-based automations.

How does prefect work?

prefect accepts workflow definitions and runtime events through its Python server, CLI, and integrations. Workers and server APIs persist execution state, which REST endpoints and web UIs expose for monitoring and management.

How do I install prefect?

Install prefect with pip install -U prefect or uv add prefect. Start a local server with prefect server start.

What language is prefect written in?

prefect is primarily written in Python. The repository also includes TypeScript and JavaScript code for its web interfaces.

How is the prefect code organized?

prefect is organized around the src directory, server and worker orchestration, integrations, tests, documentation, and the ui and ui-v2 web interfaces. Central Python files include prefect/__init__.py and prefect/logging/loggers.py.

When should I use prefect?

Use prefect to build and operate Python data pipelines that need scheduling, retries, caching, dependencies, branching, or event-based execution. Workflow activity can be monitored through a self-hosted server or Prefect Cloud.

What license does prefect use?

prefect uses the Apache-2.0 license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of prefecthq/prefect from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.