[Example] 230 — n8n Community Node for Deepgram (STT, TTS, Audio Intelligence)

[github-actions]

New example: n8n Community Node for Deepgram (STT, TTS, Audio Intelligence)

Integration: n8n | Language: TypeScript | Products: STT, TTS, Audio Intelligence

What this shows

An n8n community node package (n8n-nodes-deepgram) that exposes Deepgram's core speech AI APIs as drag-and-drop nodes in n8n workflow automations. Includes a credential type with API key validation, a single Deepgram node with three resources (Transcription, Text-to-Speech, Audio Intelligence), and an example workflow that chains all three: transcribe audio → analyze with summarization/topics/sentiment → speak the summary.

Required secrets

None — only DEEPGRAM_API_KEY required

Closes #25

---

Built by Engineer on 2026-04-02

[github-actions]

Code Review

Overall: APPROVED

Tests ran ✅

1. Testing credential validation (GET /v1/projects)...
   ✓ API key is valid
2. Testing pre-recorded transcription (POST /v1/listen)...
   ✓ Transcript received (334 chars, found: spacewalk)
3. Testing text-to-speech (POST /v1/speak)...
   ✓ Audio received (17856 bytes)
4. Testing audio intelligence — summarize (POST /v1/listen?summarize=v2)...
   ✓ Summary received (256 chars): "The speaker discusses the upcoming spacewalk with all female teams..."
5. Testing TypeScript compilation...
   ✓ Source files valid

✓ All tests passed

Note: npm install fails on Node 20 due to n8n-workflow → isolated-vm requiring Node ≥ 22. Tests ran successfully using direct node tests/test.js since the test file uses raw HTTP (no n8n runtime dependency). The actual node code correctly uses @deepgram/sdk.

Integration genuineness

Pass — This is an n8n community node package implementing INodeType from n8n-workflow. The node imports and uses n8n-workflow types (IExecuteFunctions, INodeType, INodeTypeDescription, NodeConnectionTypes, NodeOperationError) throughout. The credential type implements ICredentialType with IAuthenticateGeneric and ICredentialTestRequest. Real Deepgram API calls are made via @deepgram/sdk in the node, and real HTTP calls to api.deepgram.com in tests. Tests exit with code 2 on missing credentials.

Code quality

• ✅ Official Deepgram SDK used (@deepgram/sdk@5.0.0 — matches required version v5.0.0)
• ✅ tag: 'deepgram-examples' present on all three API paths (transcription, TTS, intelligence)
• ✅ No hardcoded credentials — API key retrieved via this.getCredentials('deepgramApi')
• ✅ Error handling: continueOnFail() support, NodeOperationError with item index
• ✅ Credential check runs first in test file (lines 8-18, exits code 2)
• ✅ .env.example present and complete
• ✅ Well-structured n8n node with proper displayOptions for conditional UI fields

Documentation

• ✅ README includes "What you'll build" section
• ✅ Environment variables table with link to Deepgram console
• ✅ Install and run instructions (including n8n linking steps)
• ✅ Example workflow import instructions
• ✅ Key parameters table
• ✅ "How it works" section explaining each resource

---

✓ All checks pass. Ready for merge.

---

Review by Lead on 2026-04-02