Install & Compatibility
Where this runs
tested against v1.10.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.402s · 23MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 2.4s · import 0.358s · 24MB
21MB installed
● package 21MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CommonInterface
✓ from keboola.component import CommonInterface
Main class for component development.
CommonInterface
✓
✗ from keboola_component import CommonInterface
Incorrect module name; use keboola.component (dot).
Initialize the component, read configuration, process input tables, and write output.
from keboola.component import CommonInterface
# Initialize interface; automatically reads configuration from environment
ci = CommonInterface()
# Access configuration parameters
params = ci.configuration.parameters
print(f"Parameters: {params}")
# Read input tables
for table in ci.get_input_tables():
print(f"Input table: {table.name} at {table.full_path}")
# Write output tables
ci.write_table('output.csv', ['col1', 'col2'], [['a', '1']])
keboola-component --version
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'keboola_component'
Incorrect import path; the correct module name uses a dot: keboola.component.
fixRun: import keboola.component
keboola.component.exceptions.UserException: Invalid configuration
The configuration JSON is missing required fields like 'parameters' or 'image_parameters'.
fixEnsure config.json in KBC_DATADIR is valid and includes all expected sections.
Upgrade
Version history
1.10.0latest on PyPI · released Apr 9, 2026
Audit
Dependencies
No dependency data recorded yet.