{"id":44761333,"url":"https://github.com/thewh1teagle/sona","last_synced_at":"2026-02-16T02:57:22.202Z","repository":{"id":336315504,"uuid":"1149154088","full_name":"thewh1teagle/sona","owner":"thewh1teagle","description":"Sona is a local transcription runner built on top of whisper.cpp.","archived":false,"fork":false,"pushed_at":"2026-02-08T04:44:45.000Z","size":18108,"stargazers_count":3,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-08T10:57:33.042Z","etag":null,"topics":["golang","whisper","whispercpp"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thewh1teagle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-03T19:31:02.000Z","updated_at":"2026-02-08T04:44:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/thewh1teagle/sona","commit_stats":null,"previous_names":["thewh1teagle/sonara"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/thewh1teagle/sona","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewh1teagle%2Fsona","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewh1teagle%2Fsona/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewh1teagle%2Fsona/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewh1teagle%2Fsona/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thewh1teagle","download_url":"https://codeload.github.com/thewh1teagle/sona/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewh1teagle%2Fsona/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29499374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-16T02:07:14.481Z","status":"online","status_checked_at":"2026-02-16T02:03:22.852Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["golang","whisper","whispercpp"],"created_at":"2026-02-16T02:57:20.462Z","updated_at":"2026-02-16T02:57:22.196Z","avatar_url":"https://github.com/thewh1teagle.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sona 🎧\n\nSona is a local transcription runner built on top of whisper.cpp.\n\nIt runs as a standalone process and exposes an OpenAI-compatible HTTP API, so other apps (desktop apps, Python scripts, etc.) can spawn it and talk to it easily.\n\nThink of it as a small, fast, local Whisper server you control.\n\n---\n\n## Why Sona ✨\n\n- Fully local transcription\n- Cross-platform single binary\n- GPU-accelerated by default\n- OpenAI-compatible API\n- Designed to be spawned and owned by another process\n- No heavy setup, no long-running system service\n\n---\n\n## Platform \u0026 GPU Support 🚀\n\nSona ships prebuilt binaries for:\n\n- macOS (x86_64 and arm64)\n- Linux (x86_64 and arm64)\n- Windows (x86_64)\n\nGPU acceleration is enabled by default:\n\n- macOS: CoreML / Metal\n- Linux: Vulkan\n- Windows: Vulkan\n\nSona automatically uses the best available backend for the platform.\n\n---\n\n## How It Works 🧠\n\n1. Your app starts the Sona process\n2. Sona binds to a local port (optionally chosen by the OS)\n3. Your app talks to Sona over HTTP\n4. Models are loaded and unloaded at runtime\n5. Transcription requests go through an OpenAI-compatible endpoint\n\nSona is intentionally simple and predictable, so it can be embedded into larger systems.\n\n---\n\n## Quick Start ⚡\n\n### 1. Download a release binary\n\nhttps://github.com/thewh1teagle/sona/releases\n\n### 2. Download a model\n\n```console\n./sona pull https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin\n```\n\n### 3. Start Sona\n\n```console\n./sona serve --port 0\n```\n\nUsing port 0 lets the OS assign a free port automatically.\n\nWhen ready, Sona prints a single machine-readable line to stdout:\n\n```json\n{\"status\":\"ready\",\"port\":52341}\n```\n\nThis is intended for parent processes to detect readiness and discover the bound port.\n\n---\n\n## Using Sona 🔌\n\nSona exposes an OpenAI-compatible transcription API.\n\nThis means:\n- You can use existing OpenAI SDKs\n- You don’t need custom client code\n- Switching between local (Sona) and remote (OpenAI) is trivial\n\nSee the full API reference here:\n- API docs: /docs\n- OpenAPI spec: /openapi.json\n\n---\n\n## Notes \u0026 Limitations ⚠️\n\n- One transcription runs at a time per process  \n  concurrent requests return 429\n- Maximum upload size is 1 GB\n- Non-WAV audio is automatically converted using ffmpeg\n  - system ffmpeg or a bundled binary next to sona\n\n---\n\n## When to Use Sona 🎯\n\nSona is a good fit if you want:\n- Local or offline transcription\n- Low-latency transcription in desktop apps\n- Full control over models and hardware\n- An OpenAI-like API without the OpenAI dependency\n\n---\n\n## Documentation 📚\n\n- API reference: /docs\n- OpenAPI schema: /openapi.json\n- Releases: https://github.com/thewh1teagle/sona/releases\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthewh1teagle%2Fsona","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthewh1teagle%2Fsona","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthewh1teagle%2Fsona/lists"}