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 https //kyndryl jfrog io/artifactory/api/pypi/kyn cto kaif pypi local/simple 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 https //kyndryl jfrog io/ui/repos/tree/general/kyn cto kaif pypi local/bridge agent sdk 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