Files
the-nexus/intelligence/deepdive
Alexander Whitestone ef74536e33
Some checks failed
CI / test (pull_request) Failing after 33s
CI / validate (pull_request) Failing after 26s
Review Approval Gate / verify-review (pull_request) Failing after 5s
feat: add edge-tts as zero-cost voice output provider
- Add EdgeTTSAdapter to bin/deepdive_tts.py (provider key: "edge-tts")
  default voice: en-US-GuyNeural, no API key required
- Add EdgeTTS class to intelligence/deepdive/tts_engine.py
- Update HybridTTS to try edge-tts as fallback between piper and elevenlabs
- Add --voice-memo flag to bin/night_watch.py for spoken nightly reports
- Add edge-tts>=6.1.9 to requirements.txt
- Create docs/voice-output.md documenting all providers and fallback chain
- Add tests/test_edge_tts.py with 17 unit tests (all mocked, no network)

Fixes #1126

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-08 06:29:26 -04:00
..

Deep Dive: Automated Intelligence Briefing System

Sovereign, automated daily intelligence pipeline for the Timmy Foundation fleet.

Vision

Zero-manual-input daily AI-generated podcast briefing covering:

  • arXiv (cs.AI, cs.CL, cs.LG)
  • OpenAI, Anthropic, DeepMind research blogs
  • AI newsletters (Import AI, TLDR AI)

Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│  Phase 1        │───▶│  Phase 2        │───▶│  Phase 3        │
│  Aggregation    │    │  Relevance      │    │  Synthesis      │
│  (RSS/Feeds)    │    │  (Embeddings)   │    │  (LLM Briefing) │
└─────────────────┘    └─────────────────┘    └────────┬────────┘
                                                       │
                              ┌────────────────────────┘
                              ▼
                    ┌─────────────────┐    ┌─────────────────┐
                    │  Phase 4        │───▶│  Phase 5        │
                    │  Audio (TTS)    │    │  Delivery       │
                    │  (Piper)        │    │  (Telegram)     │
                    └─────────────────┘    └─────────────────┘

Status: IMPLEMENTATION COMPLETE

This is no longer a reference scaffold — it is a production-ready executable pipeline.

Component Status File
Phase 1: Aggregation Complete pipeline.py — RSS fetcher with caching
Phase 2: Relevance Complete pipeline.py — sentence-transformers ranking
Phase 3: Synthesis Complete pipeline.py — LLM briefing generation
Phase 4: Audio Complete tts_engine.py — Piper + ElevenLabs hybrid
Phase 5: Delivery Complete pipeline.py — Telegram text + voice
Orchestrator Complete pipeline.py — asyncio CLI + Python API
Tests Complete tests/test_e2e.py — dry-run validation
Systemd Timer Complete systemd/deepdive.timer — 06:00 daily

Quick Start

See QUICKSTART.md for exact commands to run the pipeline.

Sovereignty Compliance

Component Implementation Non-Negotiable
Aggregation Local RSS polling No third-party APIs
Relevance sentence-transformers local No cloud embeddings
Synthesis Gemma 4 via Hermes llama-server No OpenAI/Anthropic API
TTS Piper TTS local No ElevenLabs
Delivery Hermes Telegram gateway Existing infra

Files

  • pipeline.py — Main orchestrator (production implementation)
  • tts_engine.py — Phase 4 TTS engine (Piper + ElevenLabs fallback)
  • config.yaml — Configuration template
  • Makefile — Build automation (make test-e2e, make install-systemd)
  • tests/ — pytest suite including end-to-end dry-run test
  • systemd/ — Daily timer for 06:00 execution
  • QUICKSTART.md — Step-by-step execution guide
  • architecture.md — Full technical specification
  • telegram_command.py — Hermes /deepdive command handler

Issue

#830 — Deep Dive: Sovereign NotebookLM + Daily AI Intelligence Briefing