Python Skill

Type

python

Variants

Restricted Imports, Full Access

Purpose: The Python skill enables agents to execute Python code with fine-grained control over module imports, execution environment, and resource limits.

Common Use Cases

Data processing and analysisParse, transform, and analyze data with Python libraries

Running Python scriptsExecute automation scripts, data pipelines, and workflows

API integrationsCall external APIs using requests, handle OAuth, process responses

Custom business logicImplement complex algorithms and domain-specific operations

Variants Overview

Variant	Security	Key Permissions	Best For	Create Command
Restricted Imports 🟢	Safe	Standard library modules only	Data processing, safe scripting	`--variant restricted_imports`
Full Access 🔴	Unrestricted	All modules, third-party packages	Data science, ML workflows	`--variant full_access`

Choosing a variant: Start with Restricted Imports and only upgrade to Full Access when third-party packages are required. See Variant Configuration for detailed differences.

Configuration

Example Configuration:

{
  "allowed_imports": ["json", "csv", "datetime", "re", "math"],
  "timeout": 120,
  "max_memory": "512MB",
  "working_directory": "/workspace"
}

📋 Full Configuration Reference

Parameter	Type	Default	Description
`allowed_imports`	array	variant-specific	Whitelist of allowed Python modules
`timeout`	number	120	Execution timeout in seconds
`max_memory`	string	”512MB”	Memory limit for Python process
`max_output_size`	string	”10MB”	Maximum output capture size
`working_directory`	string	”/“	Execution directory
`environment_variables`	object	Custom environment variables

⚙️ Variant-Specific Defaults

Restricted Imports:

allowed_imports: Standard library safe modules (json, csv, datetime, re, math, collections, itertools, etc.)
Network and shell access modules blocked

Full Access:

allowed_imports: [”*”] (all modules)
Third-party packages allowed
Higher default limits: max_memory: "2GB", timeout: 600

See: Variant Configuration Guide

Quick Start

# Create skill with variant
kubiya skill create --name "Data Processor" --type python --variant restricted_imports --enabled

# Associate with agent
kubiya skill associate agent <agent-id> <skill-id>

View Complete Examples

See full data analysis patterns, API integration workflows, and ML pipeline configurations

Python Code Execution

Inline Code Example

Agents can execute Python code directly:

import json
import datetime

data = {
    "timestamp": datetime.datetime.now().isoformat(),
    "status": "success",
    "results": [1, 2, 3, 4, 5]
}

print(json.dumps(data, indent=2))

Script Execution

Agents can run Python scripts from the filesystem:

# /opt/scripts/process_logs.py
import sys
import json
from datetime import datetime

def analyze_logs(log_file):
    # Log processing logic
    results = {"processed": True, "count": 42}
    return results

if __name__ == "__main__":
    result = analyze_logs(sys.argv[1])
    print(json.dumps(result))

Installing Additional Packages

For agents that need third-party packages, install them on the worker:

# On the worker system
pip install requests pandas numpy

# Or use requirements.txt
pip install -r /opt/agent-requirements.txt

Then allow imports in the skill configuration:

{
  "allowed_imports": ["requests", "pandas", "numpy"]
}

Package Management: Packages must be installed on the worker system before agents can import them. Coordinate with your infrastructure team for package deployment.

Security Best Practices

Whitelist Required Imports Only

Only allow the specific Python modules your agent needs.

# Good: Specific imports
allowed_imports: ["json", "csv", "datetime"]

# Risky: Too permissive
allowed_imports: ["*"]  # Allows everything

Set Memory Limits

Always configure max_memory to prevent resource exhaustion.

max_memory: "512MB"  # Prevents memory exhaustion

Configure Timeouts

Set reasonable timeouts to prevent infinite loops.

timeout: 120  # Scripts automatically terminate after 2 minutes

Performance Tip: For data-heavy operations, consider increasing max_memory and timeout values appropriately.

Import Error: Module Not Allowed

Solutions:

Add module to allowed_imports in configuration
Verify module name exactly matches Python import (e.g., urllib.parse not urllib)
Consider upgrading to Full Access variant if appropriate

Module Not Found

Solutions:

Verify package is installed on worker: pip list | grep package-name
Ensure PYTHONPATH includes package location
Install missing package: pip install package-name

Memory Limit Exceeded

Solutions:

Increase max_memory in configuration
Optimize script to use less memory (streaming, generators)
Process data in smaller batches

File System Skill

Read data files for Python processing

Shell Skill

Execute shell commands from Python

File Generation

Generate formatted output files

View All Skills

Return to built-in skills overview

Introduction

Quick Start

Web Interface

Core Concepts

Infrastructure

Type

Variants

Common Use Cases

Variants Overview

Configuration

Quick Start

View Complete Examples

Python Code Execution

Inline Code Example

Script Execution

Installing Additional Packages

Security Best Practices

File System Skill

Shell Skill

File Generation

View All Skills

Type

Variants

​Common Use Cases

​Variants Overview

​Configuration

​Quick Start

View Complete Examples

​Python Code Execution

​Inline Code Example

​Script Execution

​Installing Additional Packages

​Security Best Practices

​Troubleshooting & Related Skills

​Related Skills

File System Skill

Shell Skill

File Generation

View All Skills

Common Use Cases

Variants Overview

Configuration

Quick Start

Python Code Execution

Inline Code Example

Script Execution

Installing Additional Packages

Security Best Practices

Troubleshooting & Related Skills

Related Skills