liter_llm 1.9.2 copy "liter_llm: ^1.9.2" to clipboard
liter_llm: ^1.9.2 copied to clipboard

Universal LLM API client with Rust-powered polyglot bindings.

Dart #

Universal LLM API client for Dart/Flutter. Access 143 LLM providers through a Dart-idiomatic Future/Stream API with json_serializable-friendly types.

What This Package Provides #

  • One provider surface — chat, streaming, embeddings, images, audio, search, OCR, tools, and structured output across the provider registry.
  • Provider/model routing — call models with the provider/model convention and keep provider-specific request code out of application paths.
  • Production controls — retries, fallback, rate limits, cache layers, budgets, health checks, OpenTelemetry spans, and redacted secrets.
  • Same core as every binding — Rust, Python, Node.js, Go, Java, PHP, Ruby, .NET, Elixir, WASM, Kotlin Android, Swift, Dart, Zig, and C FFI use the same Rust implementation.
  • Dart package — Future/Stream API for Dart and Flutter clients.

Installation #

Package Installation #

System Requirements #

Quick Start #

Basic Chat #

Send a message to any provider using the provider/model prefix:

import 'package:liter_llm/liter_llm.dart';
import 'dart:io';

void main() async {
  final client = await LiterLlmBridge.createClient(
    apiKey: Platform.environment['OPENAI_API_KEY'] ?? '',
  );
  final request = ChatCompletionRequest(
    model: 'openai/gpt-4o',
    messages: [Message.user(UserMessage(content: UserContent.of('Hello!')))],
  );
  final response = await client.chat(request);
  print(response.choices[0].message.content);
}

Common Use Cases #

Next Steps #

Features #

Supported Providers (143) #

Route to any provider using the provider/model prefix convention:

Provider Example Model
OpenAI openai/gpt-4o, openai/gpt-4o-mini
Anthropic anthropic/claude-3-5-sonnet-20241022
Groq groq/llama-3.1-70b-versatile
Mistral mistral/mistral-large-latest
Cohere cohere/command-r-plus
Together AI together/meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo
Fireworks fireworks/accounts/fireworks/models/llama-v3p1-70b-instruct
Google Vertex vertexai/gemini-1.5-pro
Amazon Bedrock bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0

Complete Provider List

Key Capabilities #

  • Provider Routing -- Single client for 143 LLM providers via provider/model prefix
  • Local LLMs — Connect to locally-hosted models via Ollama, LM Studio, vLLM, llama.cpp, and other local inference servers
  • Unified API -- Consistent chat, chat_stream, embeddings, list_models interface
  • Streaming -- Real-time token streaming via chat_stream
  • Tool Calling -- Function calling and tool use across all supporting providers
  • Type Safe -- Schema-driven types compiled from JSON schemas
  • Secure -- API keys never logged or serialized, managed via environment variables
  • Observability -- Built-in OpenTelemetry with GenAI semantic conventions
  • Error Handling -- Structured errors with provider context and retry hints

Performance #

Built on a compiled Rust core for speed and safety:

  • Provider resolution at client construction -- zero per-request overhead
  • Configurable timeouts and connection pooling
  • Zero-copy streaming with SSE and AWS EventStream support
  • API keys wrapped in secure memory, zeroed on drop

Provider Routing #

Route to 143 providers using the provider/model prefix convention:

openai/gpt-4o
anthropic/claude-3-5-sonnet-20241022
groq/llama-3.1-70b-versatile
mistral/mistral-large-latest

See the provider registry for the full list.

Proxy, MCP Server & Plugin #

Run the OpenAI-compatible proxy or the MCP server

Beyond the SDK, the liter-llm CLI ships an OpenAI-compatible proxy and a Model Context Protocol (MCP) server:

brew install xberg-io/tap/liter-llm   # or: cargo install liter-llm-cli
liter-llm api --config liter-llm-proxy.toml   # OpenAI-compatible proxy
liter-llm mcp --transport stdio               # MCP tool server

# or run the proxy without installing:
docker run -p 4000:4000 -e LITER_LLM_MASTER_KEY=sk-your-key ghcr.io/xberg-io/liter-llm

To use the MCP server inside a coding agent, install the liter-llm plugin from the xberg-io/plugins marketplace — it auto-registers the server. See the MCP server and proxy server guides for configuration, CLI usage, and agent integration.

Documentation #

Part of Xberg.io #

  • Xberg — document intelligence: text, tables, metadata from 91+ formats with optional OCR.
  • Xberg Enterprise — managed extraction API with SDKs, dashboards, and observability.
  • crawlberg — web crawling and scraping with HTML→Markdown and headless-Chrome fallback.
  • html-to-markdown — fast, lossless HTML→Markdown engine.
  • liter-llm — universal LLM API client with native bindings for 14 languages and 143 providers.
  • tree-sitter-language-pack — tree-sitter grammars and code-intelligence primitives.
  • alef — the polyglot binding generator that produces every per-language binding across the 5 polyglot repos.
  • Discord — community, roadmap, announcements.

Contributing #

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Join our Discord community for questions and discussion.

License #

MIT -- see LICENSE for details.

0
likes
0
points
2.23k
downloads

Documentation

API reference

Publisher

verified publisherxberg.io

Weekly Downloads

Universal LLM API client with Rust-powered polyglot bindings.

Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

flutter_rust_bridge, freezed_annotation, http, json_annotation

More

Packages that depend on liter_llm