# cbh123/narrator

David Attenborough narrates your life

Repository: https://github.com/cbh123/narrator
Canonical: https://ross.abutalabs.com/products/narrator
Language: Python
License Family: other
Last push: 2026-07-23T00:59:59+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 35, longevity 73
- inputs: {"age_days": 1023, "days_push": 42, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4426, forks 540 (observed 2026-08-28T04:08:48.879132+00:00)

## What it is
A Python app that watches your webcam and generates David Attenborough-style narration of what it sees, using GPT vision models and ElevenLabs voice cloning. It runs a webcam capture process alongside a narrator process that produces spoken commentary.

## Use cases
- narrate my webcam feed like David Attenborough
- generate AI voice commentary from live video
- build a fun demo combining vision LLMs and text-to-speech
- clone a celebrity voice to describe what the camera sees
- experiment with OpenAI vision and ElevenLabs APIs

## When to choose
- you want a playful AI demo narrating your life in real time
- you're learning to combine vision models with voice synthesis APIs
- you have Replicate, OpenAI, and ElevenLabs API keys

## When to avoid
- you need a production-ready or licensed project (no license provided)
- you don't want to pay for OpenAI and ElevenLabs API usage
- you need offline or privacy-preserving operation

## Facets
- artifact type: application
- maturity: experimental
- function: speech-recognition, tts, llm-inference, computer-vision, image-processing
- domain: artificial-intelligence, large-language-models, entertainment, computer-vision
- platform: python, cross-platform
- tags: david-attenborough, webcam, elevenlabs, openai, replicate, voice-cloning, fun-project, desktop

## Member repositories
- cbh123/narrator (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:48.879132+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:20:56.934552+00:00, confidence not recorded.
  - readme: https://github.com/cbh123/narrator (fetched 2026-08-28T04:08:48.879132+00:00, sha 7a2c1f57f9cb)
- Data as of 2026-08-30T08:39:29.467469+00:00.