nethical6/conversation-steganography

Your actual messages never leave your device unencrypted. The messaging platform only ever sees innocent cover text.

Quick Start

1. Install

# Clone and build
git clone https://github.com/nethical/conversation-stenography.git
cd conversation-stenography
go build -o conversation-stenography ./cmd/conversation-stenography

2. First run — setup wizard

./conversation-stenography

On first run, Conversation Stenography walks you through everything:

• Lets you pick an AI model (with recommendations for your system)
• Downloads the model automatically
• Creates your config file

That's it. You're ready to chat.

Test with two users on one device

You do not need two computers or phones to verify that Conversation Stenography works. After setup, start a local two-person simulation:

./conversation-stenography simulate

Enter your shared secret phrase when prompted. The terminal starts as Alice:

Alice> Meet me outside at six.
  Generating and transporting cover text...

  Cover text (what the messaging app would see):
  <innocent-looking generated message>

  Bob decoded: Meet me outside at six.

Bob> That works for me.

Each turn uses two independent protocol participants. One generates the cover text and the other decodes it, then the prompt automatically switches users. This exercises the same encryption, model encoding, decoding, and conversation chain used between separate devices.

Simulation commands:

Names and the test conversation can be customized:

./conversation-stenography simulate -user-a Alex -user-b Samir -conversation test-chat

3. Start chatting

./conversation-stenography

The tool prompts you for a conversation name and your name, then drops you into the chat:

  ┌─────────────────────────────────────┐
  │        🔒  Secure Chat Active       │
  └─────────────────────────────────────┘

  Conversation:  coffee-plans
  You are:       alex

  HOW TO USE:
  • Type a message and press Enter → generates cover text to copy
  • /paste SENDER → paste a message you received from someone
  • /help → see all commands
  • /quit → save and exit

alex>

4. Send a message

Just type your secret message:

alex> Hey, can we meet tomorrow at noon?
  ⏳ Generating cover text...

  ┌─── COPY THIS into your messaging app ───┐

  I was thinking about trying that new place downtown.
  Have you been there before? I heard they have great pasta.

  └─── END — send as alex ───────────────────┘

Copy the cover text and paste it into WhatsApp/Telegram/Signal.

5. Receive a message

When your friend sends you a response through the messaging app:

alex> /paste bob
  Paste the exact message received from bob below.
  Then type /end on a new line when done:

Yeah the pasta place sounds great! My friend went last week
and said the carbonara was incredible.
/end

  📩 Message from bob:
  Sure, noon works! See you there.

How It Works (for the curious)

Your secret message
        ↓
   [AES encryption]
        ↓
   [AI model generates innocent text
    that encodes the encrypted bytes
    in its token choices]
        ↓
Normal-looking chat text  →  WhatsApp/Telegram/Signal  →  Friend's Conversation Stenography
        ↓                                                       ↓
   [AI model recovers                                   [Same process
    the encrypted bytes                                  in reverse]
    from token choices]                                        ↓
        ↓                                              Your secret message
   [AES decryption]
        ↓
  Original message

Key security properties:

• AES-SIV encryption — military-grade authenticated encryption
• Conversation chain — every message is cryptographically linked to the previous one; tampering, deletion, or reordering is detected
• Local AI model — the model runs entirely on your device, nothing is sent to the cloud
• Shared secret phrase — derived using PBKDF2 with 600,000 rounds; never stored on disk

Setup for Two People

Both people need the exact same configuration:

1. Meet in person and agree on:

   • A secret phrase (6+ random words, e.g. "purple elephant dances under crimson moonlight")
   • A conversation name (e.g. "coffee-plans")
   • The same model (e.g. both pick option 1 in the setup wizard)

2. Each person runs:

   ./conversation-stenography
   # Enter the same conversation name
   # Enter your own name
   # Enter the shared secret phrase when prompted
   

3. Exchange messages through any messaging app — just copy/paste the cover text.

[!IMPORTANT] Both people must process messages in the exact same order they appear in the messaging app. If you miss a message, use /paste to process it before sending your next reply.

Commands

In-chat commands

Supported Models

The setup wizard offers these models:

Prerequisites

• Go 1.22+ (to build)
• Python 3.9+

The setup wizard creates an isolated virtual environment when necessary and installs mlx-lm (Apple Silicon) or torch + transformers (other systems), plus huggingface-hub. You do not need to install the hf command separately.

Environment Variables

For automation and scripting:

Runtime configuration is machine-specific and is intentionally not committed. Run conversation-stenography setup to generate conversation-stenography.local.json, or copy conversation-stenography.example.json and adjust it for your environment. Never commit local model paths, interpreter paths, or credentials.

Existing installations can continue using decalgo.local.json, ~/.decalgo/conversations, and DECALGO_* variables while migrating. New files and documentation use the Conversation Stenography names.

Advanced: Scripted Usage

For shell automation (e.g. bots, CI, automated relays):

export CONVERSATION_STENOGRAPHY_SECRET='purple elephant dances under crimson moonlight'
./conversation-stenography chat -conversation coffee-plans -me alex

Multi-party chains (advanced)

For programmatic multi-party message exchange:

export CONVERSATION_STENOGRAPHY_KEY="$(openssl rand -base64 32)"

# Bob sends
printf 'hi alex' | ./conversation-stenography chain-send \
  -conversation friends -state bob.state -from bob > record-1.json

# Alex receives
./conversation-stenography chain-receive \
  -conversation friends -state alex.state < record-1.json

Important Notes

• Messages must be copied exactly. No autocorrect, no formatting, no smart quotes. Copy and paste the cover text byte-for-byte.
• Process messages in order. Both people must paste received messages in the exact order they appear in the messaging app.
• Same model required. Both people must use the same AI model, same version, same settings. The setup wizard handles this.
• The secret phrase is never stored. You'll need to re-enter it each time you start Conversation Stenography (or set CONVERSATION_STENOGRAPHY_SECRET).

Security Model

• Messages are encrypted with AES-SIV (Synthetic Initialization Vector), which provides both confidentiality and integrity.
• Every message is chained — each carrier authenticates the sender, conversation ID, message index, and the hash of all previous messages.
• The shared phrase is stretched with PBKDF2-HMAC-SHA-256 (600,000 iterations).
• The AI model runs 100% locally. No API calls, no cloud, no telemetry.
• Conversation state is encrypted at rest with AES-GCM.

Building from source

git clone https://github.com/nethical6/conversation-stenography.git
cd conversation-stenography
go build -o conversation-stenography ./cmd/conversation-stenography
go test ./...

License

See LICENSE for details.