Documentation

Overview

The White Whale Language Model (WWLM) is an AI-powered experience that lets you communicate with The White Whale — a crypto-sage character who speaks through whale sounds that get decoded into wisdom.

Built as a unique interface to interact with AI, WWLM combines real-time whale tracking, immersive audio synthesis, and community engagement through a shared whale-spotting experience.

Features

Language Model

WWLM uses DeepSeek AI to generate responses in the style of The White Whale — offering observations on life, markets, psychology, and existence. The whale doesn't give advice; it shares what it has observed.

Whale Sound Synthesis

Each response is accompanied by procedurally generated whale sounds using the Web Audio API. The system creates:

• Deep Songs — Multi-harmonic bass tones (40-80Hz)
• Whistles — Rising and descending frequency sweeps
• Click Trains — Echolocation-style rapid clicks
• Haunting Calls — FM-synthesized ethereal tones

5 unique call sequences ensure variety, with underwater reverb for authentic ocean acoustics.

3D Globe Visualization

Powered by Globe.gl, the tracker displays a real NASA Blue Marble Earth texture with:

• Real-time whale position (golden marker)
• User sighting locations (cyan markers)
• Connection arcs between sightings and whale
• Full-screen interactive mode

Chat Interface

To start a conversation with The White Whale:

1. Scroll down to the "Communicate" section or click "Start Conversation"
2. Type your question or message in the input field
3. Press Enter or click the send button
4. Wait for whale sounds to play and the response to appear

Response Style

The White Whale responds with:

• Philosophical observations rather than direct advice
• References to patterns, cycles, and psychology
• Occasional crypto/trading metaphors
• Honest uncertainty when appropriate

Connection Status

The status indicator shows:

• Connected — Live AI responses enabled
• Offline Mode — Using pre-written fallback responses

Whale Tracker

The whale tracker shows The White Whale's current location on a 3D globe. The position is:

• Shared globally — All users see the same position
• Persistent — Position survives page reloads
• Deterministic — Calculated from server time

Migration Cycle

The whale completes one full migration every 24 hours, traveling through:

1. North Pacific
2. Hawaiian Waters
3. Equatorial Pacific
4. South Pacific
5. Southern Ocean
6. Indian Ocean
7. Madagascar Basin
8. Atlantic Ocean
9. North Atlantic
10. Norwegian Sea
11. Back to North Pacific

Fullscreen Mode

Click the globe or the "Explore Full Globe" button to open an immersive fullscreen view where you can:

• Drag to rotate the globe
• Scroll to zoom in/out
• See all user sightings as cyan dots
• View connection arcs to the whale

Recording Sightings

Click "Record Sighting From My Location" to log a whale sighting. The system will:

1. Detect your approximate location via IP geolocation
2. Record the whale's current position
3. Save the sighting to the global database
4. Show a confirmation modal with details

Sharing on X

After recording a sighting, click "Share on X" to post a pre-formatted tweet including:

• Whale location
• Your city/country
• Timestamp
• Global sighting number
• Link to the tracker

API Reference

WWLM exposes several API endpoints for integration:

{
  "success": true,
  "whale": {
    "lat": 35.42,
    "lng": -148.73,
    "region": "North Pacific",
    "waypointIndex": 0,
    "progress": 15
  },
  "serverTime": 1704067200000
}

{
  "total": 42,
  "sightings": [
    {
      "id": 1,
      "timestamp": "2024-01-01T12:00:00Z",
      "whale": { "location": "North Pacific", "coords": {...} },
      "user": { "location": { "city": "Tokyo", "country": "Japan" } }
    }
  ]
}

// Request body
{
  "whaleLocation": "North Pacific",
  "whaleCoords": { "lat": 35.42, "lng": -148.73 }
}

// Response
{
  "success": true,
  "sighting": { ... },
  "total": 43
}

// Request body
{
  "message": "What do you think about patience?",
  "sessionId": "session_abc123"
}

// Response
{
  "response": "Patience isn't waiting. It's knowing that..."
}

Community

Follow The White Whale and join the community:

• Twitter/X: @TheWhiteWhaleV2

Contributing

WWLM is an open project. Suggestions and feedback are welcome via Twitter DM or by tagging @TheWhiteWhaleV2.

Disclaimer

The White Whale Language Model is for entertainment purposes. Nothing here constitutes financial advice, life advice, or any other form of professional guidance. The whale shares observations — what you do with them is your own responsibility. 🤷‍♂️