konch

library6.1.0pypypi✓ verified 85d ago

CLI and configuration utility for the Python shell, optimized for simplicity and productivity. Current version 6.1.0, with infrequent releases.

devops

pip install konch

github ↗homepage ↗

INSTALL

IMPORT

SIG · KONCH

konch

devopspythonv6.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

konch

✓ import konch

Basic usage: start a Python shell with custom context.

import konch # Create a simple config config = { 'shell': 'ipython', 'context': { 'foo': 'bar' } } konch.start(config)

Debug

Known issues

breakingIn version 6.0.0, the 'config' argument to konch.start changed from a Config object to a plain dict. Old code passing a Config object will break.

fix

Pass a dict instead of a Config object to konch.start.

affects: >=6.0.0

deprecatedThe 'shell' config key no longer supports 'bpython' as of version 6.0.0.

fix

Use 'ipython' or 'ptpython' instead.

affects: >=6.0.0

gotchakonch.start() modifies the global namespace; if you import konch inside a function, the context may not be available.

fix

Import konch at module level and call konch.start() at the end of the script.

affects: all

Errors

Common errors & fixes

ImportError: cannot import name 'Config' from 'konch'

The Config class was removed in konch 6.0.0.

fix

Use a plain dict for configuration instead of Config().

konch: error: unrecognized arguments: --shell

CLI argument parsing changed in version 6.0.0; the --shell flag was renamed to --shell-type.

fix

Use --shell-type instead of --shell when running konch from the command line.

AttributeError: module 'konch' has no attribute 'start'

konch was installed incorrectly or an older version (pre 6.0.0) may have a different API.

fix

Install konch >=6.0.0: pip install --upgrade konch. The start function is available as konch.start().

Upgrade

Version history

6.1.0latest on PyPI · released Apr 14, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/sloria/konch/ ↗

homepagehttps://github.com/sloria/konch/ ↗