Skip to content

Repository files navigation

VoidScribe — The "Burn After Reading" Journaling Listener

A minimal, ephemeral journaling listener designed for emotional catharsis and zero-footprint privacy. Whisper your frustrations, quiet wins, or unsent words to the void. The AI reads it, offers a single empathetic two-sentence reflection, and then your words permanently disintegrate into stardust.

🌐 Live Production App: https://voidscribe.vercel.app


✨ Why VoidScribe for Portfolios & Real-World Use

  • Zero-Storage Privacy Architecture: Zero database, zero chat history, zero telemetry, and zero localStorage of confessions. Text exists in-memory in-flight and is actively scrubbed upon release.
  • Deep Emotional Intelligence: AI is strictly prompted to validate human emotions and offer grounding, liberating two-sentence perspectives without lecturing or preachiness.
  • Multiple Inference Providers:
    • Local Ollama (100% free, private, offline-capable with automated model discovery).
    • Direct Cloud APIs (Google Gemini, OpenAI, Groq, OpenRouter, Anthropic) directly from the client.
    • Built-in Offline Empathy Engine (60+ emotional archetypes for immediate out-of-the-box operation with zero setup).
  • Sensory Immersion:
    • HTML5 Canvas particle disintegration engine that breaks sentences into rising embers, sparks, and smoke.
    • Pure Web Audio API synthesized procedural soundscapes (Cosmic Void 432Hz, Rain on Window, Night Fire Embers, Tibetan Singing Bowl).
    • Somatic 4-7-8 Breathing & Grounding Guide.

🚀 Quick Start

1. Install & Run Locally

# Install dependencies
npm install

# Start development server
npm run dev

Visit http://localhost:3000 in your browser.


🦙 Running with Local Ollama (100% Free & Private)

To run completely offline with local models:

  1. Install Ollama from ollama.com.
  2. Pull your model of choice (e.g. llama3.2, mistral, gemma2, phi3):
    ollama pull llama3.2
  3. Run Ollama with CORS origins allowed so your browser can communicate directly with the local server:
    OLLAMA_ORIGINS="*" ollama serve
  4. In VoidScribe, open Settings (Sliders icon) $\rightarrow$ Select Local Ollama $\rightarrow$ Click Test Connection $\rightarrow$ Select your installed model!

🛠️ Tech Stack

  • Framework: React 19, TypeScript, Vite
  • Styling: TailwindCSS v4, Google Fonts (Cinzel, Cormorant Garamond, Plus Jakarta Sans)
  • Graphics: HTML5 Canvas 2D particle physics engine
  • Audio: Web Audio API (procedural oscillator & noise synthesis)
  • Icons: Lucide React

🔒 Privacy Guarantee

  • No Database: There is no database or backend saving your messages.
  • No Telemetry: No analytical trackers or third-party ad pixels.
  • In-Memory Wipe: When you click Release to the Void or Burn Instantly, the string buffer is erased from React state and replaced with empty memory.

About

A minimal, ephemeral journaling listener designed for emotional catharsis and zero-footprint privacy. Whisper your frustrations, quiet wins, or unsent words to the void. The AI reads it, offers a single empathetic two-sentence reflection, and then your words permanently disintegrate into stardust.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages