Skip to main content

Real-time microphone → OpenAI → text (CLI)

Project description

# Transcriber

> Real-time **microphone + system-audio → OpenAI → transcript → summary** — all from a single CLI command.

---

**setup**  
  ```bash
  transcriber setup                     # prompts for API key & model – writes .env

– Captures the default microphone and the loop-back that matches your current output device. – Works on (Pulse/ALSA). – Streams 24 kHz PCM16 chunks; prints each finalized text fragment in the terminal. – On Ctrl-C it saves a timestamped .txt transcript and generates a one-paragraph summary via OpenAI Chat.

# 1. install
pip install transcriber-sh          # or: pip install git+https://github.com/Dogmeat0/transcriber.git

# 2. initial configuration
transcriber setup                # enter your OpenAI API key and choose model

# 3. record!
transcriber                      # press Ctrl-C to stop & get summary
Command What it does
transcriber list-dev Lists all microphones / loop-backs & the current defaults.
OPENAI_API_KEY = sk-************************************
MODEL          = gpt-4o-mini-transcribe


```bash
git clone https://github.com/Dogmeat0/transcriber.git
cd transcriber
python -m venv env && source env/bin/activate
pip install -e ".[dev]"             # editable + dev tools
ruff check transcriber              # lint
pytest                               # tests (if/when added)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

transcriber_sh-0.1.2.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

transcriber_sh-0.1.2-py3-none-any.whl (10.5 kB view details)

Uploaded Python 3

File details

Details for the file transcriber_sh-0.1.2.tar.gz.

File metadata

  • Download URL: transcriber_sh-0.1.2.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.1

File hashes

Hashes for transcriber_sh-0.1.2.tar.gz
Algorithm Hash digest
SHA256 c12bd42cdc8465f8a0ae60787e4ab7f26f913aa69f2775e996da4cefd7f17030
MD5 e663911f6f587a01ac823e8d8c1d1052
BLAKE2b-256 02f44cf96d603795b156061c4a9a235e2c813bc63d03eb6e76f924807b847b89

See more details on using hashes here.

File details

Details for the file transcriber_sh-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: transcriber_sh-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 10.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.1

File hashes

Hashes for transcriber_sh-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 7a8d3da0db5e997f2544e753e9430bc29a25e14e6f1136da95542f264199b321
MD5 9161040422b8c86e83a4c238d84c4964
BLAKE2b-256 1796270737cba9c0896811d3c5c3af81be98059774e3c41d7b8b218a7e2b7172

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page