Development environment

To set up your development environment, configure your IDE, editor settings, and the environment variables required for different runtime modes and LLM providers.

Recommended IDE Setup: VS Code with the following extensions: - Python (Microsoft) - Pylance - Python Debugger - Docker - GitLens - GitHub Copilot (optional)

VS Code Settings:

{

  "python.defaultInterpreterPath": "${{workspacefolder}}/venv/bin/python",

  "python.analysis.typeCheckingMode": "basic",

  "editor.formatOnSave": true,

  "python.formatting.provider": "black"

}

You will need different environment variables depending on your runtime mode and LLM provider. No OPENAI_API_KEY needed in bridge_dev, the LLM Gateway handles authentication.

Core Variables (all modes)

Variable	Description	Example
KAIF_MODE	Runtime mode	local_dev / bridge_dev / production
LLM_MODEL	Model to use	gpt-4.1-mini

Local_dev: Choose ONE provider

Provider	Required variables
OpenAI (default)	LLM_PROVIDER=openai, OPENAI_API_KEY=sk-..., OPENAI_API_BASE=https://api.openai.com/v1
Azure OpenAI	LLM_PROVIDER=azure_openai, AZURE_OPENAI_ENDPOINT, AZURE_OPENAI_API_KEY, AZURE_OPENAI_API_VERSION, AZURE_OPENAI_DEPLOYMENT
Hosted LLM	LLM_PROVIDER=hosted_llm, HOSTED_LLM_BASE_URL, HOSTED_LLM_AUTH_HEADER, HOSTED_LLM_MODEL

Bridge_dev

Variable	Description	Example
KAIF_HOST	Bridge Platform URL (required)	https://dev1-aws-oregon-base.bridge.kyndryl.com
SERVICE_API_KEY	Service ID API key (required)	(from Bridge Admin Console)
BRIDGE_ACCOUNT_ID	Your Bridge account ID (required)	abc123...

Access and repositories

This content covers the GitHub organization, key repositories, and SDK access for Bridge agent development. As an agent developer, you must have access to the kyndryl-agentic-ai GitHub organization.

You do NOT need access to kyndryl-cto. All resources required for agent development are available in kyndryl-agentic-ai

Request access

If you do not have access to kyndryl-agentic-ai:

Submit a ServiceNow request for GitHub org access.

Or contact your team lead to add you to the organization.

Key repositories

In kyndryl-agentic-ai organization

Repository	Purpose
bdg-sw-agents-bridge-agent-template	Template repo: Start here for new agents (actively evolving - always pull latest)
bridge-kaif-reusable-workflows	CI/CD GitHub Actions workflows
Debugging-remediation-help-Agent	Reference agent: debugging and remediation workflow
bdg-sw-agents-autonomous-doc-creation	Reference agent: autonomous document generation
bdg-sw-agents-incident-enrichment	Reference agent: multi-step workflow with MCP tools, ChatOps, and audit

Repository access matrix

Repository	You need
Template repo	Read + Use as template
Your agent repo	Admin (you create it)
Reusable workflows	Read (referenced in CI/CD)

The Bridge Agent SDK is distributed through Kyndryl’s JFrog Artifactory PyPI repository. Developers can access the repository and browse the available SDK packages through JFrog Artifactory under Bridge Agent SDK. The current SDK version is bridge-agent-sdk==1.0.23.

Always check JFrog Artifactory for the latest published version and update your requirements.txt accordingly.

Configure pip for Artifactory

Option 1: In requirements.txt (Recommended)

--extra-index-url: https://kyndryl.jfrog.io/artifactory/api/pypi/kyn-cto-kaif-pypi-local/simple
bridge-agent-sdk==1.0.23 
langchain>=0.3.0 
langgraph>=0.2.0
# ... other dependencies

Option 2: Global pip Configuration

Create or edit your pip configuration file:

Linux/macOS:

~/.config/pip/pip.conf 
[global] 
extra-index-url = https://kyndryl.jfrog.io/artifactory/api/pypi/kyn-cto-kaif-pypi-local/simple 
trusted-host = kyndryl.jfrog.io

Windows:

%APPDATA%\pip\pip.ini [global] 
extra-index-url = https://kyndryl.jfrog.io/artifactory/api/pypi/kyn-cto-kaif-pypi-local/simple
trusted-host = kyndryl.jfrog.io

Authentication: If prompted for authentication, use your Kyndryl SSO credentials or generate an API key from JFrog.

Verify access

Test GitHub access: Clone the template repo (should work if you have access).

Test Artifactory Access: Create a test virtual environment

python -m venv test-env  source test-env/bin/activate 
 # Linux/macOS # .\test-env\Scripts\Activate.ps1  
 # Windows

Install SDK

pip install bridge-agent-sdk==1.0.23 \ 
--extra-index-url 
https://kyndryl.jfrog.io/artifactory/api/pypi/kyn-cto-kaif-pypi-local/simple

Verify installation

python -c "from bridge_agent_sdk import BridgeBaseAgent; print('SDK installed successfully!')"

Clean up

deactivate 
rm -rf test-env