sarvam-ai-sdk 0.3.0-beta → 0.4.0

package/README.md

@@ -1,245 +1,238 @@
-<a href="https://github.com/rajatsandeepsen/sarvam-ai-sdk">
-    <img alt="cover" src="https://github.com/rajatsandeepsen/sarvam-ai-sdk/blob/master/cover.png?raw=true" />
-</a>
-
-# AI SDK - Sarvam Provider
-
-The **[Sarvam provider](https://v6.ai-sdk.dev/providers/community-providers/sarvam)** for the [AI SDK](https://v6.ai-sdk.dev/docs)
-contains language model support for the Sarvam chat completion, Text-to-Speech and Speech-to-Text APIs.
-
-## Setup
-
-The **[Sarvam](http://sarvam.ai)** provider is available in the `sarvam-ai-sdk` module. You can install it with
-
-```bash
-npm i sarvam-ai-sdk ai@6
-```
-
-> [!WARNING]
-> This package only works with Vercel AI-SDK v6, not v7. Make sure to install `ai@6` in your project.
-
-## Provider Instance
-
-You can import the default provider instance `sarvam` from `sarvam-ai-sdk`:
-
-```ts
-import { sarvam } from 'sarvam-ai-sdk';
-```
-
-Create `.env` file with API key from **[Sarvam Dashboard](https://dashboard.sarvam.ai/)**
-```bash
-SARVAM_API_KEY="your_api_key"
-```
-
-## Example
-
-```ts
-import { sarvam } from 'sarvam-ai-sdk';
-import { generateText } from 'ai';
-
-const { text } = await generateText({
-	model: sarvam("sarvam-30b"),
-    prompt: "Translate this to malayalam: 'Keep cooking, guys'",
-});
-
-console.log(text); // പാചകം തുടരൂ, സുഹൃത്തുക്കളേ
-```
-
-## Text-to-Speech
-
-```ts
-import { sarvam } from "sarvam-ai-sdk";
-import { experimental_generateSpeech as generateSpeech } from "ai";
-import { writeFile } from "fs/promises";
-
-const { audio } = await generateSpeech({
-    model: sarvam.speech("bulbul:v3", "ml-IN"),
-    text: "പാചകം തുടരൂ, സുഹൃത്തുക്കളേ",
-});
-
-const audioBuffer = Buffer.from(audio.base64, "base64")
-await writeFile("./src/transcript-test.wav", audioBuffer);
-```
-
-## Speech-to-Text
-
-```ts
-import { sarvam } from "sarvam-ai-sdk";
-import { experimental_transcribe as transcribe } from "ai";
-import { readFile } from "fs/promises";
-
-const { text } = await transcribe({
-    model: sarvam.transcription("saarika:v2.5", "ml-IN"),
-    audio: await readFile("./src/transcript-test.wav"),
-});
-
-console.log(text); // പാചകം തുടരും സുഹൃത്തുക്കളെ
-```
-
-```ts
-import { sarvam } from "sarvam-ai-sdk";
-import { experimental_transcribe as transcribe } from "ai";
-import { readFile } from "fs/promises";
-
-const { text } = await transcribe({
-    model: sarvam.transcription("saaras:v3", "en-IN"),
-    audio: await readFile("./src/transcript-test.wav"),
-});
-
-console.log(text); // Pachakam thudaroo, suhruthukkale.
-```
-
-## Speech-to-Text-Translate
-
-```ts
-import { sarvam } from "sarvam-ai-sdk";
-import { experimental_transcribe as transcribe } from "ai";
-import { readFile } from "fs/promises";
-
-const result = await transcribe({
-    model: sarvam.speechTranslation("saaras:v2.5"),
-    audio: await readFile("./src/transcript-test.wav"),
-});
-
-console.log(result.text); // Cooking continues, my friends
-```
-
-## Translation
-
-> NB: Only transliterates `prompt` and `role:user` messages, not `role:system` not `role:assistant`.
-
-```ts
-import { sarvam } from "sarvam-ai-sdk";
-import { generateText } from "ai";
-
-const result = await generateText({
-	model: sarvam.translation("mayura:v1", {
-        "from": "ml-IN",
-        "to": "en-IN",
-    }),
-    prompt: "ഇതൊക്കെ ശ്രദ്ധിക്കണ്ടേ അംബാനെ?",
-});
-
-console.log(result.text); // Shouldn't we be careful about this, Ambane?
-```
-
-## Transliterate
-
-> NB: Only transliterates `prompt` and `role:user` messages, not `role:system` not `role:assistant`.
-
-```ts
-import { sarvam } from "sarvam-ai-sdk";
-import { generateText } from "ai";
-
-const result = await generateText({
-  model: sarvam.transliterate({
-      to: "ml-IN",
-      from: "en-IN", // optional
-  }),
-  prompt: "eda mone, happy alle?",
-});
-
-console.log(result.text); // എടാ മോനെ, ഹാപ്പി അല്ലേ?
-```
-
-## Language Identification
-
-> NB: Only identifies `prompt` and `role:user` messages, not `role:system` not `role:assistant`.
-
-```ts
-import { sarvam } from "sarvam-ai-sdk";
-import { generateText } from "ai";
-
-const result = await generateText({
-    model: sarvam.languageIdentification(),
-    prompt: "ബുദ്ധിയാണ് സാറേ ഇവൻ്റെ മെയിൻ",
-});
-
-console.log(result.text); // ml-IN
-```
-
-## Tool Calling
-
-```ts
-import { z } from "zod";
-import { generateText, tool } from "ai";
-import { sarvam } from "sarvam-ai-sdk";
-
-
-const result = await generateText({
-  model: sarvam("sarvam-30b"),
-  tools: {
-    weather: tool({
-      description: "Get the weather in a location",
-      inputSchema: z.object({
-		location: z.string(),
-      }),
-      execute: async ({ location }) => ({
-        location,
-        temperature: 72 + Math.floor(Math.random() * 21) - 10,
-      }),
-    }),
-  },
-  system: "Your are a helpful AI",
-  prompt: "കൊച്ചിയിലെ കാലാവസ്ഥ എന്താണ്?",
-});
-
-console.log(result.toolResults);
-```
-
-## Generate JSON object
-
-```ts
-import { z } from "zod";
-import { sarvam } from "sarvam-ai-sdk";
-import { generateObject } from 'ai';
-
-const { object } = await generateObject({
-  model: sarvam("sarvam-30b"),
-  schemaName: "Recipe",
-  schemaDescription: "A recipe with a name, ingredients and steps",
-  schema: z.object({
-    recipe: z.object({
-      name: z.string(),
-      ingredients: z.array(z.string()),
-      steps: z.array(z.string()),
-    }),
-  }),
-  prompt: 'Generate a South Indian recipe, in Malayalam',
-});
-
-console.log(object);
-```
-
-## All APIs
-
-```ts
-import { sarvam } from "sarvam-ai-sdk";
-
-// Text-to-Text + Chat Completion
-sarvam("sarvam-105b");
-sarvam.languageModel("sarvam-30b");
-
-// Text-to-Text + Transliteration
-sarvam.transliterate({ to: "ml-IN", from: "en-IN" });
-
-// Text-to-Text + Translation
-sarvam.translation("mayura:v1", { from: "en-IN", to: "ml-IN" });
-
-// Text-to-Text + Language identification
-sarvam.languageIdentification();
-
-// Text-to-Speech
-sarvam.speech("bulbul:v3", "ml-IN");
-
-// Speech-to-Text + Transcribe to same language
-sarvam.transcription("saarika:v2.5");
-
-// Speech-to-Text + Translate to English
-sarvam.speechTranslation("saaras:v3");
-```
-
-
-## Documentation
-
-Please check out the **[Sarvam provider documentation](https://v6.ai-sdk.dev/providers/community-providers/sarvam)** and **[Sarvam API documentation](https://docs.sarvam.ai)** for more information.
+<a href="https://github.com/rajatsandeepsen/sarvam-ai-sdk">
+    <img alt="cover" src="https://github.com/rajatsandeepsen/sarvam-ai-sdk/blob/master/cover.png?raw=true" />
+</a>
+
+# AI SDK - Sarvam Provider
+
+The **[Sarvam provider](https://v6.ai-sdk.dev/providers/community-providers/sarvam)** for the [AI SDK](https://v6.ai-sdk.dev/docs)
+contains language model support for the Sarvam chat completion, Text-to-Speech and Speech-to-Text APIs.
+
+## Setup
+
+The **[Sarvam](http://sarvam.ai)** provider is available in the `sarvam-ai-sdk` module. You can install it with
+
+```bash
+npm i sarvam-ai-sdk ai@6
+```
+
+> [!WARNING]
+> This package only works with Vercel AI-SDK v6, not v7. Make sure to install `ai@6` in your project.
+
+## Provider Instance
+
+You can import the default provider instance `sarvam` from `sarvam-ai-sdk`:
+
+```ts
+import { sarvam } from 'sarvam-ai-sdk';
+```
+
+Create `.env` file with API key from **[Sarvam Dashboard](https://dashboard.sarvam.ai/)**
+```bash
+SARVAM_API_KEY="your_api_key"
+```
+
+## Example
+
+```ts
+import { sarvam } from 'sarvam-ai-sdk';
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+	model: sarvam("sarvam-30b"),
+    prompt: "Translate this to malayalam: 'Keep cooking, guys'",
+});
+
+console.log(text); // പാചകം തുടരൂ, സുഹൃത്തുക്കളേ
+```
+
+## Text-to-Speech
+
+```ts
+import { sarvam } from "sarvam-ai-sdk";
+import { experimental_generateSpeech as generateSpeech } from "ai";
+import { writeFile } from "fs/promises";
+
+const { audio } = await generateSpeech({
+    model: sarvam.speech("bulbul:v3", "ml-IN"),
+    text: "പാചകം തുടരൂ, സുഹൃത്തുക്കളേ",
+});
+
+const audioBuffer = Buffer.from(audio.base64, "base64")
+await writeFile("./src/transcript-test.wav", audioBuffer);
+```
+
+## Speech-to-Text
+
+```ts
+import { sarvam } from "sarvam-ai-sdk";
+import { experimental_transcribe as transcribe } from "ai";
+import { readFile } from "fs/promises";
+
+const { text } = await transcribe({
+    model: sarvam.transcription("saaras:v3", "en-IN"),
+    audio: await readFile("./src/transcript-test.wav"),
+});
+
+console.log(text); // Pachakam thudaroo, suhruthukkale.
+```
+
+## Translation
+
+> NB: Only translates `prompt` and `role:user` messages, not `role:system` not `role:assistant`.
+
+```ts
+import { sarvam } from "sarvam-ai-sdk";
+import { generateText } from "ai";
+
+const result = await generateText({
+	model: sarvam.translation("mayura:v1", {
+        "from": "ml-IN",
+        "to": "en-IN",
+    }),
+    prompt: "ഇതൊക്കെ ശ്രദ്ധിക്കണ്ടേ അംബാനെ?",
+});
+
+console.log(result.text); // Shouldn't we be careful about this, Ambane?
+```
+
+## Transliterate
+
+> NB: Only transliterates `prompt` and `role:user` messages, not `role:system` not `role:assistant`.
+
+```ts
+import { sarvam } from "sarvam-ai-sdk";
+import { generateText } from "ai";
+
+const result = await generateText({
+  model: sarvam.transliterate({
+      to: "ml-IN",
+      from: "en-IN", // optional
+  }),
+  prompt: "eda mone, happy alle?",
+});
+
+console.log(result.text); // എടാ മോനെ, ഹാപ്പി അല്ലേ?
+```
+
+## Language Identification
+
+> NB: Only identifies `prompt` and `role:user` messages, not `role:system` not `role:assistant`.
+
+```ts
+import { sarvam } from "sarvam-ai-sdk";
+import { generateText } from "ai";
+
+const result = await generateText({
+    model: sarvam.languageIdentification(),
+    prompt: "ബുദ്ധിയാണ് സാറേ ഇവൻ്റെ മെയിൻ",
+});
+
+console.log(result.text); // ml-IN
+```
+
+## Tool Calling
+
+```ts
+import { z } from "zod";
+import { generateText, tool } from "ai";
+import { sarvam } from "sarvam-ai-sdk";
+
+
+const result = await generateText({
+  model: sarvam("sarvam-30b"),
+  tools: {
+    weather: tool({
+      description: "Get the weather in a location",
+      inputSchema: z.object({
+		location: z.string(),
+      }),
+      execute: async ({ location }) => ({
+        location,
+        temperature: 72 + Math.floor(Math.random() * 21) - 10,
+      }),
+    }),
+  },
+  system: "Your are a helpful AI",
+  prompt: "കൊച്ചിയിലെ കാലാവസ്ഥ എന്താണ്?",
+});
+
+console.log(result.toolResults);
+```
+
+## Generate JSON object
+
+```ts
+import { z } from "zod";
+import { sarvam } from "sarvam-ai-sdk";
+import { generateObject } from 'ai';
+
+const { object } = await generateObject({
+  model: sarvam("sarvam-30b"),
+  schemaName: "Recipe",
+  schemaDescription: "A recipe with a name, ingredients and steps",
+  schema: z.object({
+    recipe: z.object({
+      name: z.string(),
+      ingredients: z.array(z.string()),
+      steps: z.array(z.string()),
+    }),
+  }),
+  prompt: 'Generate a South Indian recipe, in Malayalam',
+});
+
+console.log(object);
+```
+
+## Document Intelligence
+
+Digitize documents (PDF, PNG, JPEG, ZIP of images) using Sarvam Vision with OCR support for 23 languages.
+Returns a ZIP buffer containing the extracted content.
+
+```ts
+import { sarvam } from "sarvam-ai-sdk";
+import { readFile, writeFile } from "fs/promises";
+
+const file = await readFile("./invoice.pdf");
+
+const result = await sarvam.documentIntelligence.digitize(
+    file,
+    "invoice.pdf",
+    { language: "hi-IN", outputFormat: "md" },
+);
+
+await writeFile("./output.zip", result.output);
+console.log(`Pages processed: ${result.pageMetrics.pagesSucceeded}`);
+```
+
+## All APIs
+
+```ts
+import { sarvam } from "sarvam-ai-sdk";
+
+// Text-to-Text + Chat Completion
+sarvam("sarvam-105b");
+sarvam.languageModel("sarvam-30b");
+
+// Text-to-Text + Transliteration
+sarvam.transliterate({ to: "ml-IN", from: "en-IN" });
+
+// Text-to-Text + Translation
+sarvam.translation("mayura:v1", { from: "en-IN", to: "ml-IN" });
+
+// Text-to-Text + Language identification
+sarvam.languageIdentification();
+
+// Text-to-Speech
+sarvam.speech("bulbul:v3", "ml-IN");
+
+// Speech-to-Text
+sarvam.transcription("saaras:v3");
+
+// Document Intelligence (Sarvam Vision)
+sarvam.documentIntelligence.digitize(file, "document.pdf", { language: "hi-IN" });
+```
+
+
+## Documentation
+
+Please check out the **[Sarvam provider documentation](https://v6.ai-sdk.dev/providers/community-providers/sarvam)** and **[Sarvam API documentation](https://docs.sarvam.ai)** for more information.