skip to navigation
skip to content

konch 0.1.0

Customizes your Python shell.

Latest Version: 2.4.0

konch is a utility libary and command line interface for creating custom Python shells.

  • Automatically import any object upon startup
  • Per-project configuration
  • Compatible with IPython and BPython (automatically falls back to built-in interpreter)


Get it now

$ pip install konch

Get started

Just use the konch command to run your interactive Python interpreter.

$ konch init
$ konch

To customize your shell environment, edit the .konchrc file created when you ran konch init.

.konchrc is just a regular Python file that calls the konch.config(config_dict) function.

You can pass any of the following options:

  • context: A dictionary of objects that will be available to you in your shell session.
  • shell: Default shell to use. May be konch.IPythonShell, konch.BPythonShell, konch.PythonShell, or konch.AutoShell (default).
  • banner: Custom banner text to show.

Here is an example .konchrc file that includes some functions from the requests library in its context.

import konch
import requests

    'context': {
        'httpget': requests.get,
        'httpput': requests.put,
        'httpdelete': requests.delete
    'banner': 'A humanistic HTTP shell'

For more examples, see the example_rcfiles directory.

For more info on available command-line options, run konch --help.


  • Python 2 or 3 (tested on 2.6, 2.7, 3.2, 3.3)


MIT licensed. See the bundled LICENSE file for more details.


0.1.0 (2014-03-14)

  • First release to PyPI.
File Type Py Version Uploaded on Size
konch-0.1.0.tar.gz (md5) Source 2014-03-14 11KB