KAgent LangGraph Integration

This package provides LangGraph integration for KAgent with A2A (Agent-to-Agent) server support.

Features

A2A Server Integration: Compatible with KAgent's Agent-to-Agent protocol
Event Streaming: Real-time streaming of graph execution events
FastAPI Integration: Ready-to-deploy web server for agent execution

Quick Start

from kagent.core import AsyncControllerClient, AsyncFileTokenProvider, KAgentConfig
from kagent.langgraph import KAgentApp
import os
import sqlite3
from langgraph.checkpoint.sqlite import SqliteSaver
from langgraph.graph import StateGraph
from langchain_core.messages import BaseMessage
from typing import TypedDict, Annotated, Sequence

class State(TypedDict):
    messages: Annotated[Sequence[BaseMessage], "The conversation history"]

config = KAgentConfig()
controller_client = AsyncControllerClient(
    config.grpc_url,
    agent_name=config.app_name,
    token_provider=AsyncFileTokenProvider(),
)

# Define and compile your graph
builder = StateGraph(State)
# Add nodes and edges...
checkpointer = SqliteSaver(sqlite3.connect(
    os.getenv("KAGENT_CHECKPOINT_DB", "/tmp/langgraph-checkpoints.sqlite"),
    check_same_thread=False,
))
graph = builder.compile(checkpointer=checkpointer)

# Create KAgent app
app = KAgentApp(
    graph=graph,
    agent_card={
        "name": "my-langgraph-agent",
        "description": "A LangGraph agent with KAgent integration",
        "version": "0.1.0",
        "capabilities": {"streaming": True},
        "defaultInputModes": ["text"],
        "defaultOutputModes": ["text"]
    },
    config=config,
    controller_client=controller_client,
)

# Build FastAPI application
fastapi_app = app.build()

Architecture

The package mirrors the structure of kagent-adk but uses LangGraph instead of Google's ADK:

LangGraphAgentExecutor: Executes LangGraph workflows within A2A protocol
KAgentApp: FastAPI application builder with A2A integration
Task Management: Automatic A2A task persistence through one shared authenticated gRPC channel

Configuration

Set both endpoints when running locally. A2A and MCP use KAGENT_GATEWAY_URL, while control-plane calls use KAGENT_API_URL.

export KAGENT_API_URL=http://localhost:8083
export KAGENT_GATEWAY_URL=http://localhost:8083
export KAGENT_NAME=my-agent
export KAGENT_NAMESPACE=default

Deployment

Use the same deployment pattern as kagent-adk samples with Docker and Kubernetes.

Release files for kagent-langgraph 1.0.0a4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kagent-langgraph 1.0.0a4
File	Size	Uploaded
kagent_langgraph-1.0.0a4.tar.gz	12.7 kB	Sep 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for kagent-langgraph 1.0.0a4
File	Interpreter	ABI	Platform	Reset
kagent_langgraph-1.0.0a4-py3-none-any.whl 11.9 kB Sep 25, 2026	Python 3	none	any	Details

Total release size: 24.6 kB

Release files / kagent_langgraph-1.0.0a4.tar.gz

Download URL	kagent_langgraph-1.0.0a4.tar.gz
Size	12.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`548efff95cd7afc10bdc2fd08e356003b4a6855f3bcfd01702e56e809319134d`
BLAKE2b-256 checksum How to use checksums	`076cc5750062103c91933d743c6d3ab30e880b2ce39c40090f05833f081f5770`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / kagent_langgraph-1.0.0a4-py3-none-any.whl

Download URL	kagent_langgraph-1.0.0a4-py3-none-any.whl
Size	11.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`29827bd25713fd6f401287d88fa5df6ef08ebbef2d4269ac2a112817eebf35ab`
BLAKE2b-256 checksum How to use checksums	`cb85f4f50b9f137a5cb242d75247ad8dbbd0f20f64eb12198ba25ef0916ce58d`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`