Skip to content

armgit / Cap

Public Imported from GitHub
0

Open source Loom alternative. Beautiful, shareable screen recordings.

feat(self-hosting): add ASSEMBLY_BASE_URL for EU transcription

Noah936c65ad7939
diff --git a/apps/web/__tests__/unit/assemblyai-client.test.ts b/apps/web/__tests__/unit/assemblyai-client.test.ts
new file mode 100644
index 000000000..42a926e1f
--- /dev/null
+++ b/apps/web/__tests__/unit/assemblyai-client.test.ts
@@ -0,0 +1,46 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { realAssemblyAIResponse } from "../fixtures/assemblyai-responses";
+
+const serverEnvMock = vi.hoisted(() =>
+ vi.fn<() => Record<string, string | undefined>>(() => ({})),
+);
+
+vi.mock("@cap/env", () => ({
+ serverEnv: serverEnvMock,
+}));
+
+import { createAssemblyAIClient } from "@/lib/assemblyai";
+
+const fetchMock = vi.fn(
+ async (_input: string, _init?: RequestInit) =>
+ new Response(JSON.stringify(realAssemblyAIResponse)),
+);
+
+describe("createAssemblyAIClient", () => {
+ beforeEach(() => {
+ vi.stubGlobal("fetch", fetchMock);
+ });
+
+ afterEach(() => {
+ vi.unstubAllGlobals();
+ fetchMock.mockClear();
+ });
+
+ it.each([
+ [undefined, "https://api.assemblyai.com"],
+ ["", "https://api.assemblyai.com"],
+ ["https://api.eu.assemblyai.com", "https://api.eu.assemblyai.com"],
+ ["https://api.eu.assemblyai.com/", "https://api.eu.assemblyai.com"],
+ ])("ASSEMBLY_BASE_URL=%s sends requests to %s", async (baseUrl, host) => {
+ serverEnvMock.mockReturnValue({
+ ASSEMBLY_API_KEY: "key",
+ ASSEMBLY_BASE_URL: baseUrl,
+ });
+
+ await createAssemblyAIClient().transcripts.get(realAssemblyAIResponse.id);
+
+ expect(fetchMock.mock.calls[0]?.[0]).toBe(
+ `${host}/v2/transcript/${realAssemblyAIResponse.id}`,
+ );
+ });
+});
diff --git a/apps/web/content/docs/self-hosting.mdx b/apps/web/content/docs/self-hosting.mdx
index 45219a81b..32e16f0f9 100644
--- a/apps/web/content/docs/self-hosting.mdx
+++ b/apps/web/content/docs/self-hosting.mdx
@@ -160,6 +160,12 @@ AI_CHAT_MODEL=your-model # Support chat
AI_STREAM_MODEL=your-model # Streaming docs Ask AI
```
+To keep transcription in the EU, set:
+
+```bash
+ASSEMBLY_BASE_URL=https://api.eu.assemblyai.com
+```
+
For the AssemblyAI EU gateway, set
`AI_BASE_URL=https://llm-gateway.eu.assemblyai.com/v1`. The EU gateway only
serves Claude and Gemini models, so you must also override `AI_MODEL` and
diff --git a/apps/web/lib/assemblyai.ts b/apps/web/lib/assemblyai.ts
index 0c743dc0f..21d1fbc66 100644
--- a/apps/web/lib/assemblyai.ts
+++ b/apps/web/lib/assemblyai.ts
@@ -1,8 +1,18 @@
+import { serverEnv } from "@cap/env";
import {
AI_GENERATION_LANGUAGE_AUTO,
type AiGenerationLanguage,
type AiGenerationLanguageCode,
} from "@cap/web-domain";
+import { AssemblyAI } from "assemblyai";
+
+export function createAssemblyAIClient() {
+ const env = serverEnv();
+ return new AssemblyAI({
+ apiKey: env.ASSEMBLY_API_KEY as string,
+ baseUrl: env.ASSEMBLY_BASE_URL,
+ });
+}
export const ASSEMBLYAI_SPEECH_MODELS = [
"universal-3-5-pro",
diff --git a/apps/web/workflows/live-transcribe.ts b/apps/web/workflows/live-transcribe.ts
index 04cab1044..591dc8948 100644
--- a/apps/web/workflows/live-transcribe.ts
+++ b/apps/web/workflows/live-transcribe.ts
@@ -8,13 +8,13 @@ import {
type User,
Video,
} from "@cap/web-domain";
-import { AssemblyAI } from "assemblyai";
import { and, eq, isNull, sql } from "drizzle-orm";
import { Either, Option, Schema } from "effect";
import { isAiGenerationEnabledForUser } from "@/lib/ai-generation-entitlement";
import {
ASSEMBLYAI_SPEECH_MODELS,
ASSEMBLYAI_SUPPORTED_LANGUAGES,
+ createAssemblyAIClient,
getAssemblyAITranscriptionOptions,
} from "@/lib/assemblyai";
import {
@@ -433,9 +433,7 @@ async function processNextLiveChunk(options: {
// ffmpeg — the binary doesn't exist in the serverless runtime.
const audioBuffer = await downloadConcatenatedSegmentsToBuffer(segmentUrls);
- const client = new AssemblyAI({
- apiKey: serverEnv().ASSEMBLY_API_KEY as string,
- });
+ const client = createAssemblyAIClient();
const language = (
ASSEMBLYAI_SUPPORTED_LANGUAGES as readonly string[]
).includes(options.language)
diff --git a/apps/web/workflows/transcribe.ts b/apps/web/workflows/transcribe.ts
index a281d25f1..7be4f9171 100644
--- a/apps/web/workflows/transcribe.ts
+++ b/apps/web/workflows/transcribe.ts
@@ -17,12 +17,14 @@ import {
parseAiGenerationLanguage,
Video,
} from "@cap/web-domain";
-import { AssemblyAI } from "assemblyai";
import { and, eq, isNull, sql } from "drizzle-orm";
import { Either, Option, Schema } from "effect";
import { FatalError } from "workflow";
import { start } from "workflow/api";
-import { getAssemblyAITranscriptionOptions } from "@/lib/assemblyai";
+import {
+ createAssemblyAIClient,
+ getAssemblyAITranscriptionOptions,
+} from "@/lib/assemblyai";
import {
ENHANCED_AUDIO_CONTENT_TYPE,
ENHANCED_AUDIO_EXTENSION,
@@ -782,9 +784,7 @@ async function transcribeWithAssemblyAI(
}
const audioBuffer = Buffer.from(await audioResponse.arrayBuffer());
- const client = new AssemblyAI({
- apiKey: serverEnv().ASSEMBLY_API_KEY as string,
- });
+ const client = createAssemblyAIClient();
const transcript = await client.transcripts.transcribe({
audio: audioBuffer,
@@ -835,9 +835,7 @@ async function transcribeEditTranscriptWithAssemblyAI(
}
const audioBuffer = Buffer.from(await audioResponse.arrayBuffer());
- const client = new AssemblyAI({
- apiKey: serverEnv().ASSEMBLY_API_KEY as string,
- });
+ const client = createAssemblyAIClient();
const transcript = await client.transcripts.transcribe({
audio: audioBuffer,
...getAssemblyAITranscriptionOptions("auto"),
diff --git a/docker-compose.coolify.env.example b/docker-compose.coolify.env.example
index b57c74417..b1bf99562 100644
--- a/docker-compose.coolify.env.example
+++ b/docker-compose.coolify.env.example
@@ -62,6 +62,7 @@ RESEND_FROM_DOMAIN=
# For video transcription
ASSEMBLY_API_KEY=
+# ASSEMBLY_BASE_URL=https://api.eu.assemblyai.com
# API keys for AI summaries, chat, and docs search. When AI_PROVIDER is not
# set, providers are auto-detected from whichever of these keys are present.
diff --git a/docker-compose.coolify.yml b/docker-compose.coolify.yml
index 539d245f2..628af5069 100644
--- a/docker-compose.coolify.yml
+++ b/docker-compose.coolify.yml
@@ -24,6 +24,8 @@ services:
S3_PATH_STYLE: 'true'
RESEND_API_KEY: '${RESEND_API_KEY:-}'
RESEND_FROM_DOMAIN: '${RESEND_FROM_DOMAIN:-}'
+ ASSEMBLY_API_KEY: '${ASSEMBLY_API_KEY:-}'
+ ASSEMBLY_BASE_URL: '${ASSEMBLY_BASE_URL:-}'
GOOGLE_CLIENT_ID: '${GOOGLE_CLIENT_ID:-}'
GOOGLE_CLIENT_SECRET: '${GOOGLE_CLIENT_SECRET:-}'
APPLE_CLIENT_ID: '${APPLE_CLIENT_ID:-}'
diff --git a/docker-compose.yml b/docker-compose.yml
index 7759c6b63..98badf026 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -26,6 +26,8 @@ services:
S3_PATH_STYLE: "true"
RESEND_API_KEY: ${RESEND_API_KEY:-}
RESEND_FROM_DOMAIN: ${RESEND_FROM_DOMAIN:-}
+ ASSEMBLY_API_KEY: ${ASSEMBLY_API_KEY:-}
+ ASSEMBLY_BASE_URL: ${ASSEMBLY_BASE_URL:-}
GOOGLE_CLIENT_ID: ${GOOGLE_CLIENT_ID:-}
GOOGLE_CLIENT_SECRET: ${GOOGLE_CLIENT_SECRET:-}
APPLE_CLIENT_ID: ${APPLE_CLIENT_ID:-}
diff --git a/packages/env/server.ts b/packages/env/server.ts
index 4ae865b54..d2bccd55a 100644
--- a/packages/env/server.ts
+++ b/packages/env/server.ts
@@ -106,6 +106,12 @@ function createServerEnv() {
/// AI providers
ASSEMBLY_API_KEY: z.string().optional().describe("Audio transcription"),
+ ASSEMBLY_BASE_URL: z
+ .string()
+ .optional()
+ .describe(
+ "Transcription API base URL (eg. https://api.eu.assemblyai.com)",
+ ),
ANTHROPIC_API_KEY: z.string().optional().describe("AI chat"),
OPENAI_API_KEY: z.string().optional().describe("AI summaries"),
GROQ_API_KEY: z.string().optional().describe("AI summaries"),