PyKTANE

Welcome to PyKTANE's documentation!

Solvers for Keep Talking and Nobody Explodes: you describe the bomb, PyKTANE reads the manual. It only asks for what a rule actually needs, tracks strikes and per-module state, supports undo, and can be extended with modded module packs.

It also ships an optional MCP server, so an AI assistant can play the expert for you.

Read the Docs

Installation

PyPI

pyktane is available on PyPI:

# With uv
uv add pyktane
# With pip
pip install pyktane
# With Poetry
poetry add pyktane

For the MCP server, add the mcp extra: pyktane[mcp].

GitHub

You can also install the latest version of the code directly from GitHub:

# With uv
uv add git+https://github.com/MicaelJarniac/pyktane
# With pip
pip install git+git://github.com/MicaelJarniac/pyktane
# With Poetry
poetry add git+git://github.com/MicaelJarniac/pyktane

Usage

For more examples, see the full documentation.

As a library

from pyktane import NeedsInfo, Session

bomb = Session()
simon = bomb.add_module("Simon Says")
try:
    bomb.solve(simon, {"flashes": ["red", "green"]})
except NeedsInfo as missing:
    print(missing.fact.question)  # What is the serial number?

bomb.set_fact("serial", "AB3CD4")
bomb.solve(simon, {"flashes": ["red", "green"]}).instruction  # 'Press blue, yellow.'
bomb.strike()  # Simon Says changes with strikes.
bomb.solve(simon, {"flashes": ["red", "green"]}).instruction  # 'Press yellow, blue.'
bomb.undo()  # Misreported? Take it back.

Supported modules so far: Wires, The Button, Simon Says and Memory.

With an AI assistant (MCP)

Add this to your MCP client's configuration (Claude Desktop, Claude Code, Cursor, opencode...):

{
  "mcpServers": {
    "pyktane": {
      "command": "uvx",
      "args": ["--from", "pyktane[mcp]", "pyktane-mcp"]
    }
  }
}

Then ask your assistant to be the expert, or use the server's defuse prompt. It records the edgework, asks you what it needs, and tells you what to do.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

More details can be found in CONTRIBUTING.

Contributors ✨

License

MIT

This project was created with the MicaelJarniac/crustypy template.