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.