awoo.cf WebSocket Client
Python client and reverse-engineered protocol toolkit for the awoo.cf / nekohash real-time imageboard engine.
Architecture & Handshake Details
- Cloudflare clearance & WASM fingerprinting:
- Active session cookies extracted directly from Firefox (
~/.mozilla/firefox/*.default):cf_clearance,__cf_bm,mgc_fpc,meta_pass,captcha_session,_known.
- Active session cookies extracted directly from Firefox (
- Token Binding (
POST https://p.awoo.cf/v1/token):- Direct connection to
p.awoo.cfbackend, registering a 32-bytebindingparameter.
- Direct connection to
- WebSocket Upgrade (
wss://p.awoo.cf/api/socket?binding=<binding>):- Headers:
Origin: https://awoo.cf,Cookie: <cookies>.
- Headers:
- WebSocket 6-Step Challenge Handshake:
- Upon connection, the server sends an integer challenge
t(100000 <= t <= 1999999). - The client replies with
t + 1. - After 6 rounds of ping-pong challenges, the server sends the confirmed token string (
v2.<base64>).
- Upon connection, the server sends an integer challenge
- Dual-Mode Protocol Framing:
- ASCII/JSON Control Framing:
<2-digit-opcode><JSON payload>for synchronization (44), presence (49), NekoTV (54), and Arcade (80). - Little-Endian Binary Framing:
<8-byte float64 post_id><payload><1-byte opcode>for real-time keystroke streaming (02,03,04) and live AI token generation (Claude Thinking81, Claude11-13, Imagen14-16, Video17-34, Venice64-66, Atlas67-69, BytePlus82-84).
- ASCII/JSON Control Framing:
- Keepalive:
- Message type
48serves as periodic NOOP ping.
- Message type
Verified Capabilities
- β Full end-to-end handshake and authentication
- β Multi-instance connection support: 30 simultaneous WebSocket instances held open and synchronized
- β Live thread and post streaming with binary frame decoding
- β Complete reverse-engineered protocol documentation: see docs/NEKOHASH.md and docs/ARCHITECTURE.md
- β Arcade multiplayer protocol (19+ in-thread games) and NekoTV watch-party specification
- β
Instant client-side SHA-1 media deduplication pipeline (
/api/upload-hash)
Usage
Installation
pip install -r requirements.txt
1. Single Client Demo
python3 awoo_client.py
2. Live Thread Synchronization & Streaming
# Sync to a specific thread and stream live posts / typing events
python3 sync_thread.py --board g --thread 1256858
3. Run Concurrent Connections
# Hold open 30 concurrent connections
python3 multi_connect.py -n 30 -b all
# Or run 5 connections for 300 seconds
python3 multi_connect.py -n 5 -d 300
Inference Providers NEW
This model isn't deployed by any Inference Provider. π Ask for provider support