Billy Reader

A Firefox extension that adds pinyin annotations to Chinese text on web pages, backed by a local annotation service.

Prerequisites

• uv (Python package manager)

Setup

uv sync

Run the annotation service

uv run uvicorn server.app:app --reload --port 8000

The service runs at http://localhost:8000. API docs available at http://localhost:8000/docs.

Load the Firefox extension

1. Open about:debugging#/runtime/this-firefox in Firefox
2. Click "Load Temporary Add-on"
3. Select extension/manifest.json