Vibeleaderboard
Index / tool
Visit github.com
Category
AI Tools
Rank
No. 1007Tools index
Pricing
Open Source
Type
TOOL
Builder
meta-llama
GitHub
38 stars
Latest release
v0.3.0
Date

About

Official TypeScript library for the Llama API.

What it does

It wraps Llama REST endpoints in a server-side JavaScript and TypeScript client. Applications can send chat requests, consume server-sent event streams, upload files, inspect raw responses, and handle typed errors without building the HTTP layer themselves.

Why it's ranked here

This is a strong direct client for teams committed to the Llama API. Typed request and response fields, configurable retries and timeouts, streaming support, uploads, and raw response access cover both routine calls and lower-level integration work.

What's good

The client provides editor-visible documentation and types across request parameters and response fields. Streaming supports cancellation and splitting. Uploads accept browser files, fetch responses, Node streams, buffers, and byte arrays. Specific error classes make authentication, rate limits, timeouts, and server failures easier to distinguish.

Tradeoffs

The library is generated from an API specification, so its shape follows that specification rather than a hand-designed abstraction. Types do not validate requests at runtime. Default retries can extend waits beyond the configured timeout. Debug logging can expose sensitive request or response body data.

How to use it well

Use it in server-side TypeScript or JavaScript services that call Llama directly and benefit from typed contracts, streaming, uploads, and structured errors. Set explicit timeout and retry policies, keep debug logs away from sensitive data, and add runtime validation separately when external input reaches requests.

Technical notes+

package.json defines a public MIT-licensed npm package with CommonJS as its package type, separate CommonJS and ESM export targets, and no runtime dependencies. src/index.ts exports the default LlamaAPIClient, ClientOptions, APIPromise, upload helpers, and error classes. src/client.ts reads API credentials and configuration from options or environment variables, uses bearer authentication, defaults to the Llama v1 base URL, and exposes generic HTTP verbs for undocumented endpoints. src/core/streaming.ts implements SSE parsing, cancellation, stream splitting, and conversion to newline-separated ReadableStream data. src/core/error.ts maps HTTP statuses to specific error subclasses.

Observed

License
MIT
Primary language
TypeScript
Installation
Published publicly on npm as llama-api-client
Interface
Server-side JavaScript and TypeScript library for a REST API
Module packaging
Provides CommonJS and ESM export targets
Runtime dependencies
No runtime dependencies declared
Streaming
Supports Server Sent Events through async iteration
Generation
Source states that the client is generated from an OpenAPI specification by Stainless

Read from README.md, package.json, src/index.ts, src/error.ts, src/client.ts, src/uploads.ts, src/version.ts, src/resource.ts, src/resources.ts, src/streaming.ts, src/api-promise.ts, src/core/error.ts, src/core/uploads.ts, src/core/resource.ts, src/core/streaming.ts.

What it can do

  • Generate text completions

    Text prompts and parametersAI-generated text responses

  • Create chat conversations

    Message history and user messagesConversational AI responses

  • Execute function calls

    Function definitions and promptsStructured function call results

  • Stream real-time responses

    API requests with streaming enabledIncremental text chunks as they are generated

  • Configure model parameters

    Temperature, max tokens, and other settingsCustomized API behavior and response characteristics

  • Handle API authentication

    API keys and credentialsAuthenticated connection to Llama API services

Tags

llamasdktypescriptllmmeta

Tech Stack

Node.jsTypeScript

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.