recipe-blog-encoding

[!WARNING] Questo progetto è interamente vibe-coded ^{(probabilmente parzialmente plagiato da questo repository)} e l'autore è un dumb-dumb che ha solo pensato che l'idea fosse divertente

Usa i preamboli di ricette SEO-gaming come veicolo per codificare messaggi segreti (il prompt può essere davvero qualsiasi cosa, il prompt condiviso è semplicemente una chiave su cui encoder e decoder sono d'accordo).

Nasconde messaggi segreti in testi dall'aspetto naturale utilizzando la steganografia linguistica neurale.

Come funziona

1. L'encoder prende il tuo messaggio segreto e un prompt condiviso.
2. Ad ogni passo di generazione, costruisce una distribuzione di probabilità (CDF) sui top-k token del modello.
3. Codifica aritmetica mappa i bit del messaggio segreto sulle selezioni di token — ogni token scelto è sia una continuazione plausibile che una codifica di dati nascosti.
4. Il decoder, dato lo stesso modello e prompt, ricostruisce la CDF identica ad ogni passo e recupera i bit segreti dalle scelte di token.

Entrambi i lati devono usare lo stesso identico modello, quantizzazione, valore top-k e prompt. Qualsiasi differenza causa un fallimento della decodifica.

Prerequisiti

• Python 3.12+
• uv (consigliato) o pip
• Una GPU NVIDIA con supporto CUDA (per inferenza quantizzata a 4 bit)
  • La modalità CPU è disponibile tramite --device cpu --no-4bit ma sarà significativamente più lenta
• VRAM sufficiente per il modello scelto (~3 GB per Llama-3.2-3B in 4 bit)

Installazione

# Crea e attiva un ambiente virtuale, quindi installa i pacchetti richiesti
python -m venv env
source env/bin/activate
pip install -r requirements.txt

# oppure, usando `uv`
uv sync
uv pip install -r requirements.txt

Utilizzo

[!NOTE] Imposta la variabile d'ambiente HF_TOKEN per autenticarti su HuggingFace

Codificare un messaggio segreto

python main.py encode --message "attack at dawn"

Questo usa il prompt predefinito del preambolo di ricetta e Llama-3.2-3B. Il testo stego viene stampato su stdout e salvato in stego_output.txt.

Decodificare dal testo stego

python main.py decode --stego-file stego_output.txt

Prompt e modello personalizzati

# Codifica con un prompt personalizzato
python main.py encode \
    --message "meet me at noon" \
    --prompt "The best thing about making scrambled eggs is: "

# Decodifica (il prompt deve corrispondere esattamente!)
python main.py decode \
    --stego-file stego_output.txt \
    --prompt "The best thing about making scrambled eggs is: "

# Usa un modello diverso
python main.py encode \
    --model "mistralai/Mistral-7B-v0.3" \
    --message "secret message" \
    --prompt "Every Sunday morning my grandmother would"

Tutte le opzioni