Skip to main content

Kagenti ADK

Project description

Kagenti ADK Server SDK

Python SDK for packaging agents for deployment to Kagenti ADK infrastructure.

PyPI version License LF AI & Data

Overview

The kagenti-adk provides Python utilities for wrapping agents built with any framework (LangChain, CrewAI, BeeAI Framework, etc.) for deployment on Kagenti ADK. It handles the A2A (Agent-to-Agent) protocol implementation, platform service integration, and runtime requirements so you can focus on agent logic.

Key Features

  • Framework-Agnostic Deployment - Wrap agents from any framework for Kagenti ADK deployment
  • A2A Protocol Support - Automatic handling of Agent-to-Agent communication
  • Platform Service Integration - Connect to Kagenti ADK's managed LLM, embedding, file storage, and vector store services
  • Context Storage - Manage data associated with conversation contexts

Installation

uv add kagenti-adk

Quickstart

import os

from a2a.types import (
    Message,
)
from a2a.utils.message import get_message_text
from kagenti_adk.server import Server
from kagenti_adk.server.context import RunContext
from kagenti_adk.a2a.types import AgentMessage

server = Server()

@server.agent()
async def example_agent(input: Message, context: RunContext):
    """Polite agent that greets the user"""
    hello_template: str = os.getenv("HELLO_TEMPLATE", "Ciao %s!")
    yield AgentMessage(text=hello_template % get_message_text(input))

def run():
    try:
        server.run(host=os.getenv("HOST", "127.0.0.1"), port=int(os.getenv("PORT", 8000)))
    except KeyboardInterrupt:
        pass


if __name__ == "__main__":
    run()

Run the agent:

uv run my_agent.py

Available Extensions

The SDK includes extension support for:

  • Citations - Source attribution (CitationExtensionServer, CitationExtensionSpec)
  • Trajectory - Agent decision logging (TrajectoryExtensionServer, TrajectoryExtensionSpec)
  • Settings - User-configurable agent parameters (SettingsExtensionServer, SettingsExtensionSpec)
  • LLM Services - Platform-managed language models (LLMServiceExtensionServer, LLMServiceExtensionSpec)
  • Agent Details - Metadata and UI enhancements (AgentDetail)
  • And more - See Documentation

Each extension provides both server-side handlers and A2A protocol specifications for seamless integration with Kagenti ADK's UI and infrastructure.

Resources

Contributing

Contributions are welcome! Please see the Contributing Guide for details.

Support


Developed by contributors to the Kagenti project, this initiative is part of the Linux Foundation AI & Data program. Its development follows open, collaborative, and community-driven practices.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kagenti_adk-0.8.0rc6.tar.gz (58.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kagenti_adk-0.8.0rc6-py3-none-any.whl (96.8 kB view details)

Uploaded Python 3

File details

Details for the file kagenti_adk-0.8.0rc6.tar.gz.

File metadata

  • Download URL: kagenti_adk-0.8.0rc6.tar.gz
  • Upload date:
  • Size: 58.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for kagenti_adk-0.8.0rc6.tar.gz
Algorithm Hash digest
SHA256 424bdc62feb371e65140342e9e81319599b967e0750f24ab445155d522e953cc
MD5 c9f6220dc16edce9dec5623a5443c704
BLAKE2b-256 f3771c4781a934c263effa46e7ed7dbef568a67cdd055eae7945bbf293b81a36

See more details on using hashes here.

Provenance

The following attestation bundles were made for kagenti_adk-0.8.0rc6.tar.gz:

Publisher: release.yml on kagenti/adk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file kagenti_adk-0.8.0rc6-py3-none-any.whl.

File metadata

  • Download URL: kagenti_adk-0.8.0rc6-py3-none-any.whl
  • Upload date:
  • Size: 96.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for kagenti_adk-0.8.0rc6-py3-none-any.whl
Algorithm Hash digest
SHA256 6a5611895fdd35b8987403e2381f222eb766b0de836c686351e51a01a6adf054
MD5 10d7de90cb05d27f52fbf44f007a5ac5
BLAKE2b-256 8e42965f69ce297b253953fafd00a16c705543f7f85f38b3c3d59beed365de7d

See more details on using hashes here.

Provenance

The following attestation bundles were made for kagenti_adk-0.8.0rc6-py3-none-any.whl:

Publisher: release.yml on kagenti/adk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page