Skip to main content
Modules are the primary way to extend the Kodexa platform with custom logic. Whether you need to process documents, extract data, handle events, or provide prompts and knowledge to agents, you’ll build a module. There are two types of modules:

Python Modules

Executable Python code that processes documents, runs inference, and handles events. Used with scheduled jobs, pipelines, and assistants.

Skill Modules

File packs containing prompts, configurations, and knowledge that agents can discover and use.

​
Quick Comparison

Python ModuleSkill Module
moduleTypemodel (default)skill
ContainsPython codeFiles (prompts, configs, knowledge)
ExecutionRuns via module runtimeNot executed — read by agent
Used byScheduled jobs, pipelines, assistantsAgents
Runtime refRequired (moduleRuntimeRef)Not needed

​
Prerequisites

Before building any module, ensure you have:
  1. Python 3.11+ installed
  2. KDX CLI installed and configured — see Installation
  3. Kodexa Python SDK — pip install kodexa
  4. A Kodexa platform account with an organization

​
Deployment

Both module types are deployed the same way using kdx apply: 
kdx apply -f module.yml
This command creates or updates the module metadata and uploads your code/files in one step. See Resource Operations for more details.