sonote

Transcribe Korean meeting audio into structured JSON with optional speaker diarization.

3|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/tellang/sonote --skill sonote
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sonote
Source: https://github.com/tellang/sonote/tree/main
Command: npx skills add https://github.com/tellang/sonote --skill sonote

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires faster-whisper, yt-dlp, fastapi, uvicorn, sounddevice, numpy, watchdog, python-multipart, cryptography, httpx.

What problem does it solve?

This skill helps you turn real-time Korean speech from meetings or YouTube live streams into accurate, agent-ready transcripts without manual transcription effort.

Core Features & Use Cases

  • Real-time Korean STT CLI: Transcribe microphone input or YouTube live audio with low-latency streaming and structured output for downstream automation.
  • Speaker diarization (optional): Separate speakers using HF_TOKEN-powered diarization to make meeting transcripts easier to understand and index.
  • LLM post-processing: Automatically refine transcription and generate summaries/to-dos using supported LLM backends (Codex/Gemini/Ollama), producing more useful meeting intelligence.

Use case: You run an agent-driven workflow for a professional meeting—capture speech, get speaker-separated transcripts in JSON, then automatically produce a structured summary and action items for follow-up.

Quick Start

Run the skill in meeting mode with diarization and JSON output by starting a local server for real-time subtitles at 8000 using: sonote meeting --json.

Frequently Asked Questions about sonote

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get real-time Korean meeting transcription with speaker diarization?

Real-time Korean meeting transcription with speaker diarization is produced by capturing microphone input and using an HF_TOKEN-powered diarization process to separate speakers. You can run the meeting mode with JSON output enabled to generate structured, agent-ready transcripts for downstream automation.

Can I transcribe YouTube live streams into structured JSON for automation?

Yes, you can transcribe YouTube live streams into structured JSON by applying the tool to continuous YouTube audio workflows. It streams low-latency transcription output that is SSE and WebSocket-ready, making it suitable for downstream automation agents.

Do I need ffmpeg and HF_TOKEN to use Korean STT and diarization?

You need ffmpeg installed as a required preflight tool to process audio for Korean STT, while an optional HF_TOKEN is required specifically for enabling speaker diarization. Failures in these preflight checks map directly to typed exit codes.

How does LLM post-processing refine meeting transcripts?

LLM post-processing refines meeting transcripts by sending the initial Korean STT output to supported LLM backends like Codex, Gemini, or Ollama. This automatically generates refined text, structured summaries, and to-do items for meeting intelligence.

What is the best way to capture offline audio and video for Korean transcription?

The best way to capture offline audio and video for Korean transcription is using the scan-to-download workflow. It processes local or offline media files into machine-readable text with optional speaker diarization, returning structured JSON results.

Does faster-whisper support low-latency streaming output for agent workflows?

Faster-whisper supports low-latency streaming output for Korean speech-to-text workflows. When integrated with the FastAPI and uvicorn server setup, it produces streaming outputs that are SSE and WebSocket-ready for real-time agent applications.