GitHub - welidev/taalas-ai-provider: Ai sdk provider for Taalas

Vercel AI SDK provider for the Taalas API.

Supports chat and completion endpoints with streaming. Compatible with ai@^6.0.0 (AI SDK v6 / LanguageModelV3).

Installation

npm install taalas-ai-provider ai

Setup

Set your API key via environment variable:

export TAALAS_API_KEY=your-api-key

Or pass it directly when creating the provider:

import { createTaalas } from "taalas-ai-provider"

const taalas = createTaalas({ apiKey: "your-api-key" })

Usage

Chat

import { generateText } from "ai"
import { taalas } from "taalas-ai-provider"

const { text } = await generateText({
  model: taalas("llama3.1-8B"),
  prompt: "What is the meaning of life?",
})

Streaming

import { streamText } from "ai"
import { taalas } from "taalas-ai-provider"

const result = streamText({
  model: taalas("llama3.1-8B"),
  prompt: "Write a short poem.",
})

for await (const chunk of result.textStream) {
  process.stdout.write(chunk)
}

Completion

import { createTaalas } from "taalas-ai-provider"

const taalas = createTaalas()
const model = taalas.completion("llama3.1-8B")

Configuration

const taalas = createTaalas({
  baseURL: "https://custom-endpoint.example.com", // default: https://api.taalas.com
  apiKey: "your-api-key",                          // default: TAALAS_API_KEY env var
  headers: { "X-Custom": "value" },                // extra headers per request
})

Compatibility

taalas-ai-provider	ai (peer dep)	Specification
`0.3.x`	`^6.0.0`	LanguageModelV3
`0.2.x`	`^5.0.0`	LanguageModelV2
`0.1.x`	`^4.0.0`	LanguageModelV1

Limitations

No tool/function calling -- throws UnsupportedFunctionalityError
No structured output (JSON response format)
No file/image inputs -- text only
No embedding models
topK, frequencyPenalty, presencePenalty are accepted but produce warnings (not sent to API)

Disclaimer

This is a community project and is not affiliated with, endorsed by, or officially connected to Taalas in any way.

License

MIT