SDK & CLI open-source

Python, TypeScript et un CLI en une ligne. Licence MIT. Utilisez HiWay sans toucher au dashboard.

HiWay publie son outillage client en open source. Trois surfaces, même backend : le CLI pour les workflows terminal rapides, le SDK Python pour les scripts et notebooks, le SDK TypeScript pour le web et Node. Tout en licence MIT, tout sur GitHub dans le repo Hiway2llm/client.

Pourquoi ça compte

La plupart des proxys de routage (OpenRouter, Portkey, Helicone) livrent leurs intégrations en closed-source. HiWay publie le CLI, les SDK, les scripts d'installation, les exemples et un harness de benchmark reproductible - vous pouvez auditer exactement ce qui sort sur le réseau, self-host le CLI dans une CI air-gap, et faire tourner nos benchmarks sur votre propre workload avant de vous engager.

CLI - install en 30 secondes

Le CLI gère l'inscription, l'exécution de prompts, le monitoring du quota et les benchmarks - directement depuis votre terminal, sans dashboard.

bash

# Install (macOS, Linux, Windows via Git Bash / WSL)
curl -fsSL https://install.hiway2llm.com | sh

# Créer un compte gratuit (ouvre votre navigateur, device flow OAuth)
hw signup

# Lancer un prompt
hw run "explique l'intrication quantique en 3 puces"

# Vérifier votre quota
hw status

Commandes CLI

Commande	Description
`hw signup`	Crée un compte gratuit via device flow. Sans carte bancaire.
`hw login`	Enregistre une clé `hw_live_` existante dans `~/.hiway2llm/config.json`.
`hw run "..."`	Prompt one-shot, affiche la réponse et le modèle routé.
`hw chat`	REPL interactif.
`hw status`	Requêtes mensuelles restantes + économies cumulées vs baseline flagship.
`hw models`	Liste les modèles dispos via vos fournisseurs activés.
`hw benchmark`	Harness de benchmark reproductible sur votre propre workload.
`hw upgrade`	Ouvre la page pricing dans votre navigateur.

SDK Python

bash

pip install hiway2llm

app.py

from hiway2llm import Hiway

client = Hiway(api_key="hw_live_VOTRE_CLE")  # lit HIWAY_API_KEY si omis

response = client.chat(
    model="auto",
    messages=[{"role": "user", "content": "Résume la relativité en 3 puces"}],
)

print(response.content)
print("Routé vers :", response.routed_model, "/", response.routed_tier)

Le SDK Python est un wrapper léger sur l'endpoint OpenAI-compatible - si vous utilisez déjà openai, vous pouvez juste override base_url au lieu d'installer hiway2llm. Le SDK natif ajoute un accès typé aux métadonnées _hiway, un retry intégré sur le fallback fournisseur, et un itérateur de streaming avec comptabilisation token par token.

SDK TypeScript

bash

npm install @hiway2llm/client

hiway.ts

import { Hiway } from "@hiway2llm/client";

const client = new Hiway({ apiKey: process.env.HIWAY_API_KEY! });

const response = await client.chat({
  model: "auto",
  messages: [{ role: "user", content: "Écris un limerick sur HTTP" }],
});

console.log(response.content);
console.log("Routé vers :", response.routedModel, "/", response.routedTier);

Fonctionne sur Node 20+, Bun, Deno, Cloudflare Workers et le navigateur (avec un proxy pour l'en-tête Authorization - ne jamais livrer une clé hw_live_ côté client).

Vous préférez votre SDK existant ?

Aucun SDK HiWay n'est obligatoire pour utiliser HiWay. L'endpoint est entièrement OpenAI-compatible, donc gardez votre client openai / @ai-sdk/openai / LangChain et override juste base_url vers https://app.hiway2llm.com/v1. Voir la section Intégrations pour les snippets copier-coller.

Code source & contributions

Repo : [github.com/Hiway2llm/client](https://github.com/Hiway2llm/client)
Licence : MIT - tout l'outillage client
Le backend du router (routage intelligent, cache sémantique, facturation) est propriétaire et ne fait pas partie du repo
Issues et PRs bienvenues. Le harness de benchmark dans benchmarks/ est le meilleur endroit pour reproduire et remonter des edge cases.