# Show HN：Experiential--开源智能体工作流网关与路由器

- 来源：Hacker News 热门（buzzing.cc 中文翻译）
- 作者：SilenN
- 发布时间：2026-08-28 09:41
- AIHOT 分数：66
- AIHOT 链接：https://aihot.virxact.com/items/cmtcav6vr02oxroeevea7nv9r
- 原文链接：https://github.com/experientiallabs/experiential

## AI 摘要

Experiential 是一个面向智能体工作流的开源网关与路由器，通过一个 OpenAI 兼容 API 统一托管、BYOK 和本地模型，并支持按用户、智能体、用例及预算控制模型访问。它可将生产流量转化为针对质量、速度和成本优化的自定义路由器或模型。项目支持本地部署（pip install experiential）及托管平台，并默认启用匿名聚合遥测。

## 正文

Experiential

Experiential is an open source gateway and router for agent workflows:

Use hosted, BYOK, and local models through one OpenAI-compatible API.

Control which users and agents can use which models, for which use cases, and how much they can spend.

Turn production traffic into a custom router or model optimized for quality, speed, and cost.

🌐 Platform | 📚 Docs | Discord

Getting Started

Start a local OpenAI-compatible gateway. On first run, the setup wizard uses the shared provider, model, and reasoning-effort selectors, persists every selected provider connection, then shows defaults for the public alias, identity, and $50.00 command budget before printing a one-time key:

pip install experiential exp

Choose a public alias such as opus-5, capture the issued key, and send a request:

export EXP_GATEWAY_KEY=... curl http://127.0.0.1:8000/v1/chat/completions \ -H "Authorization: Bearer $EXP_GATEWAY_KEY" \ -H 'Content-Type: application/json' \ -d '{"model":"opus-5","messages":[{"role":"user","content":"Help me"}]}'

Setup / get started with the hosted gateway

Prefer a managed gateway to running one locally? The hosted platform at platform.experientiallabs.ai serves the same OpenAI-compatible (and Anthropic Messages) API at https://api.experientiallabs.ai/v1. See SETUP.md for copy-paste prompts you hand to your coding agent (Claude Code, Cursor, Codex, and similar); the agent runs the setup for you. It collects four prompts:

Using the API

Start the local gateway with exp (or exp run); the compiled native data plane serves every route on loopback. From Python, load a fitted project router as an official OpenAI client backed by its own private gateway:

import exp

with exp.load_router("my-project") as client: response = client.chat.completions.create( model="my-project", messages=[{"role": "user", "content": "hello"}], )

Optimize from Traffic

First, collect OpenTelemetry traces from your current agent. If you just want to try it out, grab the public terminal-tasks OTLP dataset:

curl -L -o traces.otel.jsonl \ https://huggingface.co/datasets/experiential-labs/wmo-terminal-tasks-traces/resolve/540883e451dc13d34fb50fdd36b143cb0f1fb0db/traces.otel.jsonl

Then build a project. The build command walks you through providers, models, and budget, and asks for your trace file:

# Build simulation from your agent traces and optimize a router against it exp build support-agent

After collecting traces from your router, fine-tune an open source model you own using Tinker.

exp optimize model support-agent

Telemetry

Anonymous aggregate PostHog product telemetry is enabled by default. It never includes prompts, traces, actions, observations, paths, model names, credentials, or raw customer content.

exp config telemetry status exp config telemetry disable exp config telemetry enable

The preference is stored locally in .exp/settings.toml.

Development

uv sync --extra dev uv run ruff format --check . uv run ruff check . uv run ty check uv run pytest -q

Repository and documentation conventions live in AGENTS.md.