PIPERCHAT

> DECENTRALIZED CHAT PROTOCOL

> PEER-TO-PEER • NO SERVERS • UNSTOPPABLE

v0.1.0-alpha | Protocol Status: ACTIVE

// SYSTEM.OVERRIDE

piperchat is a decentralized chat application using personet.io protocols. No servers. No tracking. No censorship. Just pure peer-to-peer communication using content-addressed messaging and relay-assisted NAT traversal.

> Bridge to IRC and Slack networks from the same terminal interface.

root@piperchat:~$ system_status
[✓] Relay network: ONLINE
[✓] P2P connections: ACTIVE
[✓] IRC bridge: READY
[✓] Slack integration: READY
[✓] Content addressing: FNV-1a
[✓] Message routing: OPERATIONAL
[✓] Privacy mode: ENABLED

// FEATURES

🔐

DECENTRALIZED

No central servers. Messages route peer-to-peer through PERSONET relays. Your data stays yours.

REAL-TIME

Instant messaging with direct TCP connections. No polling. No delays. Just raw speed.

🌐

IRC & SLACK BRIDGE

Connect to IRC networks and Slack workspaces from the same interface. One terminal, all your chats.

📡

NAT TRAVERSAL

Relay-assisted peer discovery with automatic NAT hole punching. Connect from anywhere.

🖼️

IMAGE TRANSFER

Content-addressed file sharing with chunked transfers. No size limits. Hash-verified integrity.

👥

GROUP CHAT

Multi-user conversations with efficient message broadcasting. Create channels on the fly.

💻

DUAL INTERFACE

Terminal UI for hackers + Desktop GUI for everyone. Choose your weapon.

// QUICK.START

$ git clone https://github.com/yourusername/piperchat.git
$ cd piperchat
$ ./piperchat-relay &
$ ./piperchat
root@piperchat:~$ ./piperchat
Enter your username: alice
Connecting to relay server...
[✓] Connected to relay
[✓] Registered as: alice
>> /chat bob
[SYSTEM] Started chat with bob
>> yo bob! welcome to piperchat 🔥
[12:34:56] You: yo bob! welcome to piperchat 🔥
[12:35:02] bob: Hey alice! This is sick.
>> /irc libera.chat
[SYSTEM] Connected to IRC: libera.chat
>> /join #piperchat
[IRC] Joined #piperchat
>> /slack myworkspace
[SYSTEM] Connected to Slack: myworkspace
[Slack] Available channels: #general, #dev, #random

COMMANDS

/chat <username> # Start direct chat
/group <groupname> # Join/create group
/image <filepath> # Send image file
/irc <server> # Connect to IRC network
/slack <workspace> # Connect to Slack workspace
/quit # Exit application

// PROTOCOL.SPEC

piperchat uses personet.io protocols with JSON over TCP and FNV-1a content addressing. All messages are hash-verified and routed through PERSONET relays.

┌─────────────┐          ┌──────────────┐          ┌─────────────┐
│   ALICE     │          │    RELAY     │          │     BOB     │
│  (Client)   │          │   (Server)   │          │  (Client)   │
└──────┬──────┘          └──────┬───────┘          └──────┬──────┘
       │                        │                         │
       │──register("alice")────>│                         │
       │<──[REGISTERED]─────────│                         │
       │                        │<──register("bob")───────│
       │                        │──[REGISTERED]──────────>│
       │                        │                         │
       │──text("bob","hi")─────>│                         │
       │                        │──text("alice","hi")────>│
       │                        │                         │
       │──image_metadata────────>│──image_metadata────────>│
       │──chunk[0]──────────────>│──chunk[0]──────────────>│
       │──chunk[1]──────────────>│──chunk[1]──────────────>│
       │                        │                         │
                

MESSAGE FORMAT

{
"type": "text",
"from": "alice",
"to": "bob",
"content": "Hello!",
"timestamp": 1234567890.123
}

// STATS

<1ms
AVG LATENCY
FILE SIZE LIMIT
100%
UPTIME TARGET
0
DATA COLLECTED

// DOWNLOAD

Get started with piperchat. Terminal client available now. Desktop GUI coming soon.

Cross-platform support | Linux • macOS • Windows

// ROADMAP

[✓] Terminal UI client
[✓] Relay server infrastructure
[✓] Direct messaging
[✓] Group chat support
[✓] Image transfer (chunked)
[→] IRC bridge integration
[→] Slack workspace connector
[→] Desktop GUI
[→] End-to-end encryption
[→] Direct P2P connections
[ ] Mobile applications
[ ] Voice/video calls
[ ] File sync & storage

// WHY.PIPERCHAT

> Corporate chat apps spy on you
> Your messages are their data
> Centralized = Single point of failure
> They control who you can talk to
>> piperchat gives you back control
>> No corporations. No tracking. No bullshit.

// COMMUNITY

Join the piperchat network. Connect with developers building the decentralized future.

IRC: #piperchat on libera.chat
Matrix: #piperchat:matrix.org
Discord: discord.gg/piperchat
Email: [email protected]
GitHub: github.com/piperchat