Python SDK

The available Python package is groundforge-langchain. It connects an existing LangChain or LangGraph Agent to GroundForge without moving the Agent code into the platform. The package provides:

Agent registration and Discovery;
direct-call tracing;
service mode for Channel jobs;
input and output adapters;
Gateway enforcement around Agent tools;
Operator Tasks for Review;
bounded, redacted Trace data.

Install

Install the wheel supplied with your GroundForge release in the Agent’s Python environment:

python -m pip install ./groundforge_langchain-0.2.13-py3-none-any.whl

Service mode requires websocket-client >= 1.8.

Choose a mode

Mode	Use it when
`serve=False`	Your application invokes the Agent directly and you want GroundForge Traces
`serve=True`	GroundForge Channels should dispatch jobs to the running Agent process

Example

groundforgeai/demo

Start with simple_agent_service.py, then compare the explicit adapter version.

Continue with Connect a LangChain Agent, Service Mode, and Configuration.

Last modified on July 27, 2026

Overview

Concepts

Examples

Platform

SDK

CLI

REST APIs

Operations

Reference

Install

Choose a mode

Example

groundforgeai/demo

​Install

​Choose a mode

​Example

groundforgeai/demo

Install

Choose a mode

Example