Skip to content

Installation

This project is a documentation-first cookbook for Azure Functions Python v2. You do not install it as a package to use an API. Instead, you clone the repository, read a recipe, and run one of the matching example projects.

Cookbook vs library

azure-functions-cookbook-python is not a runtime dependency. It is a recipe collection with runnable reference apps under examples/.

Prerequisites

  • Python 3.10 through 3.14 (the project currently targets >=3.10,<3.15)
  • Azure Functions Core Tools v4 (func command)
  • Git
  • Optional: Azurite for local queue testing
  • Optional: GNU Make for standardized development/test commands

Clone the Repository

git clone https://github.com/yeongseon/azure-functions-cookbook-python.git
cd azure-functions-cookbook-python

Create a Virtual Environment

python -m venv .venv

Activate it:

# macOS / Linux
source .venv/bin/activate

# Windows PowerShell
.venv\Scripts\Activate.ps1

Install Development Dependencies

You can use either the Makefile workflow or direct pip commands.

make install

This bootstraps Hatch and installs the project environments used for linting, testing, security checks, and docs.

Option B: pip workflow

pip install -e ".[dev,docs]"

Verify Tooling

func --version
python --version

If you plan to run queue recipes locally, start Azurite in another terminal:

azurite --queuePort 10001

Project Structure Overview

azure-functions-cookbook-python/
  docs/
    foundations/         Core concepts (execution model, triggers & bindings)
    patterns/           Pattern deep-dives organized by category
    reference/          Reference pages
    guides/             Practical guides
  examples/             Runnable Azure Functions sample apps
    apis-and-ingress/   HTTP trigger examples
    messaging-and-pubsub/  Queue and Service Bus examples
    orchestration-and-workflows/  Durable Functions examples
    ...                 13 category directories
  src/                  Internal package metadata and tooling support
  tests/                Repository test suite
  mkdocs.yml            Documentation site navigation and config
  Makefile              Standardized developer commands

Run a First Example

cd examples/apis-and-ingress/hello_http_minimal
pip install -e .
func start

Then call:

curl http://localhost:7071/api/hello

New contributors

If you want to improve cookbook content, continue with Development, Testing, and Contributing Guidelines.