forge docs

Python Guide

Use the Python SDK for orchestration, data workflows, and ML-adjacent integrations.

Python Guide

The Python SDK fits orchestration, ML-adjacent pipelines, and data-heavy application layers.

Primary surfaces

  • forge-py/src/forge/core
  • forge-py/src/forge/agent
  • forge-py/src/forge/identity
  • forge-py/src/forge/auth
  • forge-py/src/forge/mcp

Choose Python when

  • your orchestration layer already lives in Python
  • you need Forge concepts alongside data, automation, or ML workflows
  • you value quick iteration without abandoning runtime structure

Use Python when you need

  • orchestration in Python-centric systems
  • integration into data or ML workflows
  • fast iteration with strong typed runtime concepts

Baseline developer workflow

  1. start in forge-py
  2. run the package tests with the expected import path configuration
  3. keep provider, agent, identity, auth, and MCP flows aligned in application code

Useful verification commands

  • PYTHONPATH=src pytest
  • python3 tools/release_gate.py --root .

Current guidance

Keep public documentation honest about implementation status. Python support is tied to the same contract and release-gate expectations as every other SDK.