# murtaza-nasir/speakr

> speakr is a personal, self-hosted web application for transcribing audio recordings and turning them into organized, searchable notes. It runs on your own infrastructure, so sensitive conversations stay under your control. Transcription is handled by a configured engine, such as self-hosted WhisperX or a hosted service, and the server is a Python app built on Flask with a JavaScript front end.

Source: https://github.com/murtaza-nasir/speakr
Indexed: commit 074c490 on 2026-08-22 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: Python
- Stars: 4,176 at index time
- License: AGPL-3.0
- Code health: 6.1/10, Fair
- Last commit: 2026-08-07
- Contributors: 15

## How it works

Audio enters through the web interface, which records from a microphone, system or browser-tab audio, or accepts uploaded files, and the capture logic lives in static/js/modules/composables/audio.js. The front end is driven by static/js/app.modular.js, which coordinates the interface modules. Requests reach the server through src/app.py, the entry point that starts the Flask application. The recording endpoints in src/api/recordings.py handle the API calls that create, read and update recordings. Templates in templates render the pages, and the tests directory holds test files such as test_webhooks.py that cover the server code. Transcription is delegated to the configured engine, and the resulting transcript is used for summaries, event extraction and chat.

- src/app.py: entry point
- .github/CLA-SETUP.md: central file
- .github/workflows/cla.yml: central file
- .github/workflows/docker-publish.yml: central file
- .github/workflows/docs.yml: central file
Modules: src, tests, static, templates, docs, scripts, root, .github. 415 files, 116,309 lines, 3,459 symbols.

## Code health

- Score: 6.1/10 (Fair)
- Rank: #209 of 4,000+ indexed repos
- Hotspots: static/js/app.modular.js, static/js/modules/composables/audio.js, src/api/recordings.py, tests/test_webhooks.py, tests/test_cov_recordings_read.py
- Lowest file: src/tasks/processing.py
- Dead code: 28 findings

## Maintenance

- Last commit 2026-08-07, first commit 2026-02-10, 621 commits
- 15 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/murtaza-nasir/speakr/security

## More

- Page: https://repowise.dev/repo/murtaza-nasir/speakr
- Ask this codebase: https://repowise.dev/repo/murtaza-nasir/speakr/chat
- Docs: https://repowise.dev/repo/murtaza-nasir/speakr/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/murtaza-nasir/speakr
