deepctl 0.2.4__tar.gz → 0.2.6__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.4
3
+ Version: 0.2.6
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>
@@ -52,6 +52,7 @@ Requires-Dist: deepctl-cmd-listen>=0.0.1
52
52
  Requires-Dist: deepctl-cmd-requests>=0.0.1
53
53
  Requires-Dist: deepctl-cmd-billing>=0.0.1
54
54
  Requires-Dist: deepctl-cmd-members>=0.0.1
55
+ Requires-Dist: deepctl-cmd-completion>=0.0.1
55
56
  Requires-Dist: deepctl-shared-utils>=0.1.10
56
57
  Requires-Dist: pydantic>=2.0.0
57
58
  Requires-Dist: rich>=13.0.0
@@ -143,7 +144,7 @@ pipx run deepctl --help
143
144
  dg login
144
145
 
145
146
  # Transcribe an audio file
146
- dg transcribe recording.wav
147
+ dg listen recording.wav
147
148
 
148
149
  # Text-to-speech
149
150
  dg speak "Hello from Deepgram" -o hello.mp3
@@ -155,6 +156,77 @@ dg listen --mic
155
156
  dg read "The product is amazing" --sentiment --topics
156
157
  ```
157
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
+
158
230
  ## Features
159
231
 
160
232
  ### Speech-to-Text
@@ -338,6 +410,7 @@ cli/
338
410
  ├── packages/
339
411
  │ ├── deepctl-cmd-api/ # API command for deepctl
340
412
  │ ├── deepctl-cmd-billing/ # Billing command for deepctl
413
+ │ ├── deepctl-cmd-completion/ # Shell completion command for deepctl
341
414
  │ ├── deepctl-cmd-debug/ # Debug command group for deepctl
342
415
  │ ├── deepctl-cmd-debug-audio/ # Audio debug subcommand for deepctl
343
416
  │ ├── deepctl-cmd-debug-browser/ # Browser debug subcommand for deepctl
@@ -375,6 +448,7 @@ cli/
375
448
  |---------|-------------|
376
449
  | `deepctl api` | API command for deepctl |
377
450
  | `deepctl billing` | Billing command for deepctl |
451
+ | `deepctl completion` | Shell completion command for deepctl |
378
452
  | `deepctl debug audio` | Audio debug subcommand for deepctl |
379
453
  | `deepctl debug browser` | Browser debug subcommand for deepctl |
380
454
  | `deepctl debug network` | Network debug subcommand for deepctl |
@@ -399,6 +473,7 @@ cli/
399
473
  | `deepctl transcribe` | Transcribe command for deepctl |
400
474
  | `deepctl update` | Update command for deepctl |
401
475
  | `deepctl usage` | Usage command for deepctl |
476
+ | `deepctl whoami` | Login command for deepctl |
402
477
  <!-- END:commands -->
403
478
 
404
479
  ### Packages
@@ -408,6 +483,7 @@ cli/
408
483
  |---------|-------------|
409
484
  | [`deepctl-cmd-api`](packages/deepctl-cmd-api) | API command for deepctl |
410
485
  | [`deepctl-cmd-billing`](packages/deepctl-cmd-billing) | Billing command for deepctl |
486
+ | [`deepctl-cmd-completion`](packages/deepctl-cmd-completion) | Shell completion command for deepctl |
411
487
  | [`deepctl-cmd-debug`](packages/deepctl-cmd-debug) | Debug command group for deepctl |
412
488
  | [`deepctl-cmd-debug-audio`](packages/deepctl-cmd-debug-audio) | Audio debug subcommand for deepctl |
413
489
  | [`deepctl-cmd-debug-browser`](packages/deepctl-cmd-debug-browser) | Browser debug subcommand for deepctl |
@@ -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
@@ -259,6 +330,7 @@ cli/
259
330
  ├── packages/
260
331
  │ ├── deepctl-cmd-api/ # API command for deepctl
261
332
  │ ├── deepctl-cmd-billing/ # Billing command for deepctl
333
+ │ ├── deepctl-cmd-completion/ # Shell completion command for deepctl
262
334
  │ ├── deepctl-cmd-debug/ # Debug command group for deepctl
263
335
  │ ├── deepctl-cmd-debug-audio/ # Audio debug subcommand for deepctl
264
336
  │ ├── deepctl-cmd-debug-browser/ # Browser debug subcommand for deepctl
@@ -296,6 +368,7 @@ cli/
296
368
  |---------|-------------|
297
369
  | `deepctl api` | API command for deepctl |
298
370
  | `deepctl billing` | Billing command for deepctl |
371
+ | `deepctl completion` | Shell completion command for deepctl |
299
372
  | `deepctl debug audio` | Audio debug subcommand for deepctl |
300
373
  | `deepctl debug browser` | Browser debug subcommand for deepctl |
301
374
  | `deepctl debug network` | Network debug subcommand for deepctl |
@@ -320,6 +393,7 @@ cli/
320
393
  | `deepctl transcribe` | Transcribe command for deepctl |
321
394
  | `deepctl update` | Update command for deepctl |
322
395
  | `deepctl usage` | Usage command for deepctl |
396
+ | `deepctl whoami` | Login command for deepctl |
323
397
  <!-- END:commands -->
324
398
 
325
399
  ### Packages
@@ -329,6 +403,7 @@ cli/
329
403
  |---------|-------------|
330
404
  | [`deepctl-cmd-api`](packages/deepctl-cmd-api) | API command for deepctl |
331
405
  | [`deepctl-cmd-billing`](packages/deepctl-cmd-billing) | Billing command for deepctl |
406
+ | [`deepctl-cmd-completion`](packages/deepctl-cmd-completion) | Shell completion command for deepctl |
332
407
  | [`deepctl-cmd-debug`](packages/deepctl-cmd-debug) | Debug command group for deepctl |
333
408
  | [`deepctl-cmd-debug-audio`](packages/deepctl-cmd-debug-audio) | Audio debug subcommand for deepctl |
334
409
  | [`deepctl-cmd-debug-browser`](packages/deepctl-cmd-debug-browser) | Browser debug subcommand for deepctl |
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "deepctl"
7
- version = "0.2.4" # x-release-please-version
7
+ version = "0.2.6" # 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"
@@ -60,6 +60,7 @@ dependencies = [
60
60
  "deepctl-cmd-requests>=0.0.1",
61
61
  "deepctl-cmd-billing>=0.0.1",
62
62
  "deepctl-cmd-members>=0.0.1",
63
+ "deepctl-cmd-completion>=0.0.1",
63
64
  "deepctl-shared-utils>=0.1.10",
64
65
  "pydantic>=2.0.0",
65
66
  "rich>=13.0.0",
@@ -200,6 +201,7 @@ deepctl-cmd-listen = { workspace = true }
200
201
  deepctl-cmd-requests = { workspace = true }
201
202
  deepctl-cmd-billing = { workspace = true }
202
203
  deepctl-cmd-members = { workspace = true }
204
+ deepctl-cmd-completion = { workspace = true }
203
205
  deepctl-shared-utils = { workspace = true }
204
206
  deepctl-plugin-example = { workspace = true }
205
207
 
@@ -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.4" # x-release-please-version
4
+ __version__ = "0.2.6" # 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.4
3
+ Version: 0.2.6
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>
@@ -52,6 +52,7 @@ Requires-Dist: deepctl-cmd-listen>=0.0.1
52
52
  Requires-Dist: deepctl-cmd-requests>=0.0.1
53
53
  Requires-Dist: deepctl-cmd-billing>=0.0.1
54
54
  Requires-Dist: deepctl-cmd-members>=0.0.1
55
+ Requires-Dist: deepctl-cmd-completion>=0.0.1
55
56
  Requires-Dist: deepctl-shared-utils>=0.1.10
56
57
  Requires-Dist: pydantic>=2.0.0
57
58
  Requires-Dist: rich>=13.0.0
@@ -143,7 +144,7 @@ pipx run deepctl --help
143
144
  dg login
144
145
 
145
146
  # Transcribe an audio file
146
- dg transcribe recording.wav
147
+ dg listen recording.wav
147
148
 
148
149
  # Text-to-speech
149
150
  dg speak "Hello from Deepgram" -o hello.mp3
@@ -155,6 +156,77 @@ dg listen --mic
155
156
  dg read "The product is amazing" --sentiment --topics
156
157
  ```
157
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
+
158
230
  ## Features
159
231
 
160
232
  ### Speech-to-Text
@@ -338,6 +410,7 @@ cli/
338
410
  ├── packages/
339
411
  │ ├── deepctl-cmd-api/ # API command for deepctl
340
412
  │ ├── deepctl-cmd-billing/ # Billing command for deepctl
413
+ │ ├── deepctl-cmd-completion/ # Shell completion command for deepctl
341
414
  │ ├── deepctl-cmd-debug/ # Debug command group for deepctl
342
415
  │ ├── deepctl-cmd-debug-audio/ # Audio debug subcommand for deepctl
343
416
  │ ├── deepctl-cmd-debug-browser/ # Browser debug subcommand for deepctl
@@ -375,6 +448,7 @@ cli/
375
448
  |---------|-------------|
376
449
  | `deepctl api` | API command for deepctl |
377
450
  | `deepctl billing` | Billing command for deepctl |
451
+ | `deepctl completion` | Shell completion command for deepctl |
378
452
  | `deepctl debug audio` | Audio debug subcommand for deepctl |
379
453
  | `deepctl debug browser` | Browser debug subcommand for deepctl |
380
454
  | `deepctl debug network` | Network debug subcommand for deepctl |
@@ -399,6 +473,7 @@ cli/
399
473
  | `deepctl transcribe` | Transcribe command for deepctl |
400
474
  | `deepctl update` | Update command for deepctl |
401
475
  | `deepctl usage` | Usage command for deepctl |
476
+ | `deepctl whoami` | Login command for deepctl |
402
477
  <!-- END:commands -->
403
478
 
404
479
  ### Packages
@@ -408,6 +483,7 @@ cli/
408
483
  |---------|-------------|
409
484
  | [`deepctl-cmd-api`](packages/deepctl-cmd-api) | API command for deepctl |
410
485
  | [`deepctl-cmd-billing`](packages/deepctl-cmd-billing) | Billing command for deepctl |
486
+ | [`deepctl-cmd-completion`](packages/deepctl-cmd-completion) | Shell completion command for deepctl |
411
487
  | [`deepctl-cmd-debug`](packages/deepctl-cmd-debug) | Debug command group for deepctl |
412
488
  | [`deepctl-cmd-debug-audio`](packages/deepctl-cmd-debug-audio) | Audio debug subcommand for deepctl |
413
489
  | [`deepctl-cmd-debug-browser`](packages/deepctl-cmd-debug-browser) | Browser debug subcommand for deepctl |
@@ -25,6 +25,7 @@ deepctl-cmd-listen>=0.0.1
25
25
  deepctl-cmd-requests>=0.0.1
26
26
  deepctl-cmd-billing>=0.0.1
27
27
  deepctl-cmd-members>=0.0.1
28
+ deepctl-cmd-completion>=0.0.1
28
29
  deepctl-shared-utils>=0.1.10
29
30
  pydantic>=2.0.0
30
31
  rich>=13.0.0
File without changes
File without changes
File without changes