silentir 0.1.1

Generate structured notes from YouTube/Bilibili videos using local or online LLMs

silentir

The silentir project generates structured notes from YouTube and Bilibili URLs using local (Ollama) or online (OpenAI-compatible) models.

Install

uv sync

Optional ASR dependencies:

uv sync --extra asr

Optional example dependencies (examples/basic_usage.py):

uv sync --extra examples

Optional Streamlit UI dependencies:

uv sync --extra ui

Install dev/test dependencies:

uv sync --group dev

Quickstart

uv run silentir "https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
  --provider-policy local_first \
  --output-format markdown \
  --include-timestamps section \
  --out notes.md

Python API

from silentir import generate_notes

result = generate_notes(
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    language="auto",
    provider_policy="local_first",
    local_model="qwen2.5:7b-instruct",
    online_model="gpt-4.1-mini",
    ollama_host="http://localhost:11434",
    openai_base_url="https://api.openai.com/v1",
    openai_api_key=None,
)
print(result.note_markdown)

Run tests:

uv run pytest

Lint And Format

Install Git hooks:

uv run pre-commit install

Run checks manually:

uv run pre-commit run --all-files
uv run ruff check .
uv run ruff format .

Architecture and pipeline details:

• docs/architecture.md

Explicit Configuration

All runtime configuration is explicit. Use CLI flags or Python function arguments instead of environment variables.

Notes

• Subtitle-first transcription is used by default.
• If subtitles are unavailable, ASR transcriber fallback is used.
• Runtime provider fallback follows provider_policy.

Streamlit UI

Run the web UI:

uv run --extra ui,asr streamlit run examples/basic_ui.py

The UI exposes the same configuration options as the CLI and lets you preview and download generated notes. You can also provide an optional write path to persist the rendered notes directly to a file.

Skill

silentir can be used as an skill.

1. Ensure silentir is installed in the agent's environment.
2. Copy the skills/silentir directory to your skills folder.
3. The agent can then use the /silentir command to process video URLs.

Skill files:

• skills/silentir/SKILL.md: Manifest and metadata.
• skills/silentir/handler.py: Execution wrapper.