[!NOTE] This README was generated by SKILL, get the ZH version from here.

ONE AGENT INTERFACE FOR EVERY LLM PROVIDER

A Go LLM router library with a unified Agent interface, multi-provider routing, and normalized token usage

Extracted as a standalone package from Agenvoy 2741d4a

Since v0.28.17, Agenvoy's LLM providers are unified and replaced by this package go-llm-router.

Table of Contents

• Features
• Architecture
• License
• Author

Features

go get github.com/pardnchiu/go-llm-router · Documentation

• Unified Agent Interface — Twelve providers share one Send surface so callers never write per-vendor adapters.
• String Routing Factory — Build the right Agent from a provider@model name, with bracket tags and custom endpoints.
• Reasoning Level Normalization — Map none through xhigh onto Claude thinking, Gemini budgets, OpenAI effort, and more.
• Cross-Provider Usage Absorption — Fold prompt_tokens / input_tokens and cache fields into one Input / Output / Cache shape.
• OAuth and Image Extensions — Built-in Copilot / Codex / Grok OAuth flows, plus Codex image generation and multimodal input.

Architecture

Full Architecture

graph TB
    App[Caller] --> Router[router.New]
    Router --> Agent[core.Agent]
    Agent --> Claude[Claude]
    Agent --> OpenAI[OpenAI / Codex]
    Agent --> Gemini[Gemini]
    Agent --> Others[Grok / DeepSeek / Others]
    Agent --> OAuth[oauth]
    Agent --> Usage[Usage Normalization]

License

This project is licensed under the MIT LICENSE.

Author

邱敬幃 Pardn Chiu

hi@pardn.io
https://www.linkedin.com/in/pardnchiu

©️ 2026 邱敬幃 Pardn Chiu