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.

To run

# 1. install
pip install transcriber          # 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.1.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.1-py3-none-any.whl (10.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: transcriber_sh-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 4fba6316c2216ae666450e43efd22dadd178b06aac381e48a6578cc2a7619ec9
MD5 a34f566ec9c2f3525901ee40691f4627
BLAKE2b-256 6de33ca0ff85e4f1f038d231739f3812b7cd618711d8074c3b9dab8b39b2e127

See more details on using hashes here.

File details

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

File metadata

  • Download URL: transcriber_sh-0.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2dad36aa8f7421472ec766a2bc26061dd850e1198021435919819a777683637b
MD5 e88a1a3c81479852129552c751efef24
BLAKE2b-256 d28b4426447d4ff3c61844c3cc3d1dbae7a732d6441a988221d5a39c86656ac8

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