NekoCat 🐱

A LAN communication platform. Chat, share files, send notifications, open remote shells — all over your local network with a single pip install.

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XX  /\_/\  XX  nekocat                   XX
XX ( o.o ) XX  a lan communication       XX
XX  >   <  XX  package                   XX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Quick Start

pip install nekocat
neko setup

That's it. The daemon starts automatically and will restart on every boot.

Commands

Architecture

neko (CLI)  ──IPC─►  nekod (Daemon)  ──LAN─►  peers
   localhost:54320           port:54322

The CLI never touches the network directly. Every LAN operation is handled by nekod, which runs as a background service.

Security

• Each installation generates a unique Node ID and an Ed25519 identity key pair.
• All sessions use X25519 ephemeral key exchange so traffic is encrypted with a fresh key each time.
• First-time connections show a 6-digit pairing code that must match on both devices.
• Once paired, devices are trusted automatically.

Configuration

Config files:

• config.json — general settings
• trusted_peers.json — paired devices and their public keys
• nekocat.db — SQLite database for peer cache and all logs

License

MIT