A pure-Python implementation of the KISS Protocol for communicating with serial TNC devices for use with Amateur Radio.
Python Makefile
Latest commit 31ecfb4 Dec 15, 2016 Greg Albrecht Merge branch 'release/6.0.1'
Failed to load latest commit information.
examples updating examples Dec 14, 2016
kiss small fix for NMEA decoder Dec 15, 2016
tests updates Dec 14, 2016
.gitignore updates Apr 24, 2016
.travis.yml updates Dec 14, 2016
CONTRIBUTORS updates Dec 14, 2016
COPYRIGHT.txt updates Apr 24, 2016
LICENSE updates Apr 24, 2016
MANIFEST.in updates Apr 24, 2016
Makefile Style cleanup Dec 12, 2016
README.rst fix readme formatting Dec 15, 2016
requirements.txt updates Dec 14, 2016
setup.cfg updated email Nov 9, 2016
setup.py patch Dec 15, 2016


kiss - Python KISS Module

kiss is a Python Module that implementations the KISS Protocol for communicating with KISS-enabled devices (such as Serial or TCP TNCs).


Install from pypi using pip: pip install kiss

Usage Examples

Read & print frames from a TNC connected to '/dev/ttyUSB0' at 1200 baud:

import kiss

def p(x): print(x)  # prints whatever is passed in.

k = kiss.SerialKISS('/dev/ttyUSB0', 1200)
k.start()  # inits the TNC, optionally passes KISS config flags.
k.read(callback=p)  # reads frames and passes them to `p`.

See also: examples/ directory.


Run nosetests from a Makefile target:

make test

See Also

  • Python APRS Module Library for sending, receiving and parsing APRS Frames to and from multiple Interfaces
  • Python KISS Module Handles interfacing-to and encoding-for various KISS Interfaces.
  • Python APRS Gateway Uses Redis PubSub to run a multi-interface APRS Gateway.
  • Python APRS Tracker TK.
  • dirus Dirus is a daemon for managing a SDR to Dire Wolf interface. Manifests that interface as a KISS TCP port.

Similar Projects

  • apex by Jeffrey Phillips Freeman (WI2ARD). Next-Gen APRS Protocol. (based on this Module! :)
  • aprslib by Rossen Georgiev. A Python APRS Library with build-in parsers for several Frame types.
  • aprx by Matti & Kenneth. A C-based Digi/IGate Software for POSIX platforms.
  • dixprs by HA5DI. A Python APRS project with KISS, digipeater, et al., support.
  • APRSDroid by GE0RG. A Java/Scala Android APRS App.
  • YAAC by KA2DDO. A Java APRS Client.
  • Ham-APRS-FAP by aprs.fi: A Perl APRS Parser.
  • Dire Wolf by WB2OSZ. A C-Based Soft-TNC for interfacing with sound cards. Can present as a KISS interface!

Build Status






Github: https://github.com/ampledata/kiss


Greg Albrecht W2GMD oss@undef.net



Copyright 2016 Orion Labs, Inc. and Contributors

Automatic Packet Reporting System (APRS) is Copyright Bob Bruninga WB4APR wb4apr@amsat.org


Apache License, Version 2.0. See LICENSE for details.