deepctl 0.2.5__tar.gz → 0.2.8__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: deepctl
3
- Version: 0.2.5
3
+ Version: 0.2.8
4
4
  Summary: Official Deepgram CLI for speech recognition and audio intelligence
5
5
  Author-email: Deepgram <devrel@deepgram.com>
6
6
  Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -144,7 +144,7 @@ pipx run deepctl --help
144
144
  dg login
145
145
 
146
146
  # Transcribe an audio file
147
- dg transcribe recording.wav
147
+ dg listen recording.wav
148
148
 
149
149
  # Text-to-speech
150
150
  dg speak "Hello from Deepgram" -o hello.mp3
@@ -156,6 +156,77 @@ dg listen --mic
156
156
  dg read "The product is amazing" --sentiment --topics
157
157
  ```
158
158
 
159
+ ## Examples
160
+
161
+ ### Speech-to-text
162
+
163
+ ```bash
164
+ # File or URL — auto-detected
165
+ dg listen keynote.mp3 --diarize --model nova-3
166
+ dg listen https://cdn.example.com/podcast.mp3
167
+
168
+ # Pipe to jq for scripting
169
+ dg listen standup.mp3 -o json \
170
+ | jq '.results.channels[0].alternatives[0].transcript'
171
+
172
+ # Live microphone with interim (partial) results
173
+ dg listen --mic --model nova-3 --interim
174
+
175
+ # Raw audio stream from ffmpeg
176
+ ffmpeg -i video.mp4 -f s16le -ar 16000 -ac 1 - \
177
+ | dg listen --encoding linear16
178
+ ```
179
+
180
+ ### Captions (WebVTT & SRT)
181
+
182
+ ```bash
183
+ # Generate a WebVTT file
184
+ dg listen keynote.mp3 --webvtt --save-to keynote.vtt
185
+
186
+ # SRT with speaker labels
187
+ dg listen interview.mp3 --srt --diarize --save-to interview.srt
188
+
189
+ # Stream live captions from the microphone
190
+ dg listen --mic --webvtt
191
+
192
+ # Captions from a video via ffmpeg
193
+ ffmpeg -i video.mp4 -f s16le -ar 16000 -ac 1 - \
194
+ | dg listen --encoding linear16 --srt
195
+ ```
196
+
197
+ ### Text intelligence
198
+
199
+ ```bash
200
+ dg read earnings.txt --sentiment --summarize --topics
201
+ ```
202
+
203
+ ### Text-to-speech
204
+
205
+ ```bash
206
+ # Stream directly to a player
207
+ dg speak "Hello from Deepgram" | ffplay -nodisp -autoexit -
208
+ ```
209
+
210
+ ### Account & project management
211
+
212
+ ```bash
213
+ dg whoami # Auth status
214
+ dg projects --list # List projects
215
+ dg keys --create --comment 'ci-pipeline' --dry-run # Dry-run key creation
216
+ dg usage --last-month # Usage stats
217
+ dg requests --status failed --endpoint listen # Debug failed requests
218
+ ```
219
+
220
+ ### Raw API & MCP
221
+
222
+ ```bash
223
+ # Hit any endpoint directly
224
+ dg api /v1/projects --jq '.projects[0].name'
225
+
226
+ # MCP server for AI editors (Claude Code, Cursor, etc.)
227
+ dg mcp --transport sse --port 8000
228
+ ```
229
+
159
230
  ## Features
160
231
 
161
232
  ### Speech-to-Text
@@ -64,7 +64,7 @@ pipx run deepctl --help
64
64
  dg login
65
65
 
66
66
  # Transcribe an audio file
67
- dg transcribe recording.wav
67
+ dg listen recording.wav
68
68
 
69
69
  # Text-to-speech
70
70
  dg speak "Hello from Deepgram" -o hello.mp3
@@ -76,6 +76,77 @@ dg listen --mic
76
76
  dg read "The product is amazing" --sentiment --topics
77
77
  ```
78
78
 
79
+ ## Examples
80
+
81
+ ### Speech-to-text
82
+
83
+ ```bash
84
+ # File or URL — auto-detected
85
+ dg listen keynote.mp3 --diarize --model nova-3
86
+ dg listen https://cdn.example.com/podcast.mp3
87
+
88
+ # Pipe to jq for scripting
89
+ dg listen standup.mp3 -o json \
90
+ | jq '.results.channels[0].alternatives[0].transcript'
91
+
92
+ # Live microphone with interim (partial) results
93
+ dg listen --mic --model nova-3 --interim
94
+
95
+ # Raw audio stream from ffmpeg
96
+ ffmpeg -i video.mp4 -f s16le -ar 16000 -ac 1 - \
97
+ | dg listen --encoding linear16
98
+ ```
99
+
100
+ ### Captions (WebVTT & SRT)
101
+
102
+ ```bash
103
+ # Generate a WebVTT file
104
+ dg listen keynote.mp3 --webvtt --save-to keynote.vtt
105
+
106
+ # SRT with speaker labels
107
+ dg listen interview.mp3 --srt --diarize --save-to interview.srt
108
+
109
+ # Stream live captions from the microphone
110
+ dg listen --mic --webvtt
111
+
112
+ # Captions from a video via ffmpeg
113
+ ffmpeg -i video.mp4 -f s16le -ar 16000 -ac 1 - \
114
+ | dg listen --encoding linear16 --srt
115
+ ```
116
+
117
+ ### Text intelligence
118
+
119
+ ```bash
120
+ dg read earnings.txt --sentiment --summarize --topics
121
+ ```
122
+
123
+ ### Text-to-speech
124
+
125
+ ```bash
126
+ # Stream directly to a player
127
+ dg speak "Hello from Deepgram" | ffplay -nodisp -autoexit -
128
+ ```
129
+
130
+ ### Account & project management
131
+
132
+ ```bash
133
+ dg whoami # Auth status
134
+ dg projects --list # List projects
135
+ dg keys --create --comment 'ci-pipeline' --dry-run # Dry-run key creation
136
+ dg usage --last-month # Usage stats
137
+ dg requests --status failed --endpoint listen # Debug failed requests
138
+ ```
139
+
140
+ ### Raw API & MCP
141
+
142
+ ```bash
143
+ # Hit any endpoint directly
144
+ dg api /v1/projects --jq '.projects[0].name'
145
+
146
+ # MCP server for AI editors (Claude Code, Cursor, etc.)
147
+ dg mcp --transport sse --port 8000
148
+ ```
149
+
79
150
  ## Features
80
151
 
81
152
  ### Speech-to-Text
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "deepctl"
7
- version = "0.2.5" # x-release-please-version
7
+ version = "0.2.8" # x-release-please-version
8
8
  description = "Official Deepgram CLI for speech recognition and audio intelligence"
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -1,7 +1,7 @@
1
1
  """deepctl - Official command-line interface for Deepgram's speech
2
2
  recognition API."""
3
3
 
4
- __version__ = "0.2.5" # x-release-please-version
4
+ __version__ = "0.2.8" # x-release-please-version
5
5
  __author__ = "Deepgram"
6
6
  __email__ = "devrel@deepgram.com"
7
7
  __license__ = "MIT"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: deepctl
3
- Version: 0.2.5
3
+ Version: 0.2.8
4
4
  Summary: Official Deepgram CLI for speech recognition and audio intelligence
5
5
  Author-email: Deepgram <devrel@deepgram.com>
6
6
  Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -144,7 +144,7 @@ pipx run deepctl --help
144
144
  dg login
145
145
 
146
146
  # Transcribe an audio file
147
- dg transcribe recording.wav
147
+ dg listen recording.wav
148
148
 
149
149
  # Text-to-speech
150
150
  dg speak "Hello from Deepgram" -o hello.mp3
@@ -156,6 +156,77 @@ dg listen --mic
156
156
  dg read "The product is amazing" --sentiment --topics
157
157
  ```
158
158
 
159
+ ## Examples
160
+
161
+ ### Speech-to-text
162
+
163
+ ```bash
164
+ # File or URL — auto-detected
165
+ dg listen keynote.mp3 --diarize --model nova-3
166
+ dg listen https://cdn.example.com/podcast.mp3
167
+
168
+ # Pipe to jq for scripting
169
+ dg listen standup.mp3 -o json \
170
+ | jq '.results.channels[0].alternatives[0].transcript'
171
+
172
+ # Live microphone with interim (partial) results
173
+ dg listen --mic --model nova-3 --interim
174
+
175
+ # Raw audio stream from ffmpeg
176
+ ffmpeg -i video.mp4 -f s16le -ar 16000 -ac 1 - \
177
+ | dg listen --encoding linear16
178
+ ```
179
+
180
+ ### Captions (WebVTT & SRT)
181
+
182
+ ```bash
183
+ # Generate a WebVTT file
184
+ dg listen keynote.mp3 --webvtt --save-to keynote.vtt
185
+
186
+ # SRT with speaker labels
187
+ dg listen interview.mp3 --srt --diarize --save-to interview.srt
188
+
189
+ # Stream live captions from the microphone
190
+ dg listen --mic --webvtt
191
+
192
+ # Captions from a video via ffmpeg
193
+ ffmpeg -i video.mp4 -f s16le -ar 16000 -ac 1 - \
194
+ | dg listen --encoding linear16 --srt
195
+ ```
196
+
197
+ ### Text intelligence
198
+
199
+ ```bash
200
+ dg read earnings.txt --sentiment --summarize --topics
201
+ ```
202
+
203
+ ### Text-to-speech
204
+
205
+ ```bash
206
+ # Stream directly to a player
207
+ dg speak "Hello from Deepgram" | ffplay -nodisp -autoexit -
208
+ ```
209
+
210
+ ### Account & project management
211
+
212
+ ```bash
213
+ dg whoami # Auth status
214
+ dg projects --list # List projects
215
+ dg keys --create --comment 'ci-pipeline' --dry-run # Dry-run key creation
216
+ dg usage --last-month # Usage stats
217
+ dg requests --status failed --endpoint listen # Debug failed requests
218
+ ```
219
+
220
+ ### Raw API & MCP
221
+
222
+ ```bash
223
+ # Hit any endpoint directly
224
+ dg api /v1/projects --jq '.projects[0].name'
225
+
226
+ # MCP server for AI editors (Claude Code, Cursor, etc.)
227
+ dg mcp --transport sse --port 8000
228
+ ```
229
+
159
230
  ## Features
160
231
 
161
232
  ### Speech-to-Text
File without changes
File without changes
File without changes