LangChain integration for OSOP (Open Standard Operating Procedures) workflows. Load, validate, visualize, and use .osop.yaml workflow files in LangChain chains and agents.
pip install langchain-osopfrom langchain_osop import OsopWorkflowLoader
# Load a single workflow
loader = OsopWorkflowLoader("path/to/workflow.osop.yaml")
docs = loader.load()
print(docs[0].page_content) # Human-readable description
print(docs[0].metadata) # Structured metadata (node_count, edge_count, etc.)
# Load all workflows from a directory
docs = OsopWorkflowLoader.from_directory("path/to/workflows/")from langchain_osop import OsopWorkflowRunnable
runnable = OsopWorkflowRunnable.from_file("workflow.osop.yaml")
# Get structured data
chain = runnable.as_runnable()
result = chain.invoke("analyze this workflow")
# Generate Mermaid diagram
mermaid = runnable.to_mermaid()
print(mermaid)
# Get node summaries for prompts
nodes = runnable.get_node_descriptions()from langchain_osop import create_osop_tools
from langchain.agents import create_react_agent
tools = create_osop_tools()
# Provides: osop_validate, osop_describe, osop_to_mermaid
agent = create_react_agent(llm, tools)| Tool | Description |
|---|---|
osop_validate |
Validate OSOP YAML — checks required fields, node types, edge modes, dangling references |
osop_describe |
Generate human-readable workflow description |
osop_to_mermaid |
Convert workflow to Mermaid diagram |
OSOP is the standard format for describing and logging AI agent workflows. Core uses 4 node types (agent, api, cli, human) and 4 edge modes. See osop.ai for the full spec.
- OSOP Spec
- OSOP MCP Server — 5 MCP tools (validate, render, report, diff, risk_assess)
- OSOP Interop — Format converters (CrewAI, n8n, Airflow, etc.)
- Visual Editor
Apache License 2.0