Experiential은 에이전트 워크플로우를 위한 오픈 소스 게이트웨이 및 라우터입니다:
- 하나의 OpenAI 호환 API를 통해 호스팅형, BYOK(Bring Your Own Key), 로컬 모델을 사용할 수 있습니다.
- 어떤 사용자 및 에이전트가 어떤 사용 사례에 대해 어떤 모델을 사용할 수 있는지, 그리고 얼마나 많은 비용을 지출할 수 있는지 제어합니다.
- 프로덕션 트래픽을 품질, 속도, 비용에 최적화된 커스텀 라우터 또는 모델로 변환합니다.
로컬 OpenAI 호환 게이트웨이를 시작하세요. 첫 실행 시, 설정 마법사가 공유 제공업체(provider), 모델, 추론 노력(reasoning-effort) 선택기를 사용하여 모든 선택된 제공업체 연결을 저장한 다음, 퍼블릭 별칭(public alias), ID, 그리고 $50.00의 명령 예산(command budget)에 대한 기본값을 표시하고 일회용 키를 출력합니다:
pip install experiential
exp
opus-5와 같은 퍼블릭 별칭을 선택하고, 발급된 키를 캡처한 다음 요청을 보냅니다:
export EXP_GATEWAY_KEY=...
curl http://127.0.0.1:8000/v1/chat/completions \
-H "Authorization: Bearer $EXP_GATEWAY_KEY" \
...
로컬에서 실행하는 것보다 관리형 게이트웨어를 선호하십니까? platform.experientiallabs.ai에 있는 호스팅 플랫폼은 https://api.experientiallabs.ai/v1에서 동일한 OpenAI 호환(및 Anthropic Messages) API를 제공합니다.
코딩 에이전트(Claude Code, Cursor, Codex 등)에게 전달할 복사 붙여넣기 프롬프트는 SETUP.md를 참조하세요. 에이전트가 설정을 대신 수행합니다. 이 과정에서 네 가지 프롬프트를 수집합니다:
- LLM 트레이스를 텔레메트리(telemetry)로 업로드: 이메일로 즉시 계정을 생성한 다음, 기존 LLM 트레이스를 플랫폼에 텔레메트리로 가져오거나 업로드합니다.
- 추론 제공업체 키 연결 (BYOK): 계정을 생성한 후, 무료 패스스루를 위해 자체 OpenAI, Anthropic, Gemini, Azure, Bedrock, Fireworks 또는 OpenRouter 키를 연결합니다.
- 게이트웨이에서 모델 호출 시작:
xpl_을 사용하여 OpenAI 및 Anthropic SDK로 첫 번째 /v1 호출을 수행합니다.
key를 설정하고 선택적으로 기존 코딩 에이전트를 재지정할 수 있습니다. - 전체 온보딩: 이메일로 즉시 계정을 생성하고, 키를 연결하며, 지출 내역을 가져온 다음, 모든 코딩 에이전트(Claude Code, Cursor, Codex, Aider 및 유사 도구) 또는 게이트웨이의 Conductor를 재지정합니다.
exp로 로컬 게이트웨이를 시작하거나
(
또는 exp run)
; 컴파일된 네이티브 데이터 플레인은 루프백에서 모든 라우트를 서비스합니다. Python에서는 적합한 프로젝트 라우터를 공식 OpenAI 클라이언트로 로드할 수 있으며, 이는 자체 사설 게이트웨이에 의해 지원됩니다:
import exp
with exp.load_router("my-project") as client:
response = client.chat.completions.create(
...
Capture는 기존 ChatGPT 또는 Claude 구독을 사용하여 Codex 및 Claude Code 데스크톱 앱에서 지원되는 트레이스를 수집하도록 설계되었으며, 요청은 OpenAI 또는 Anthropic으로 직접 전송됩니다. macOS와 Python 3.13 이상이 필요하며, 확장 기능 및 인증서에 대한 승인이 필요합니다:
exp capture
Capture는 실험적이며, macOS 네트워크 신뢰성은 여전히 조사 중입니다.
Experiential의 게이트웨이를 미들웨어로 사용하여 비용을 제어하고, 가드레일을 적용하며, 품질, 비용 및 속도를 최적화하세요. 작업하는 동안 터미널을 열어두세요. Ctrl+C를 눌러 캡처를 중지합니다. 캡처 원격 측정(telemetry)을 확인하세요.
먼저 현재 에이전트로부터 OpenTelemetry 트레이스를 수집하세요. 단순히 사용해보고 싶다면, 공개 터미널 작업 OTLP 데이터셋을 가져오세요:
curl -L -o traces.otel.jsonl \
그런 다음 프로젝트를 빌드합니다. 빌드 명령어는 제공업체(providers), 모델, 예산에 대해 안내하며, 트레이스 파일을 요청합니다:
라우터로부터 트레이스를 수집한 후, Tinker를 사용하여 소유하는 오픈 소스 모델을 미세 조정하세요.
exp optimize model support-agent
익명화된 집계 PostHog 제품 원격 측정(telemetry)은 기본적으로 활성화됩니다. 이는 프롬프트, 트레이스, 작업, 관찰 내용, 경로, 모델 이름, 자격 증명 또는 원시 고객 콘텐츠를 절대 포함하지 않습니다.
exp config telemetry status
exp config telemetry disable
exp config telemetry enable
선호도는 .exp/settings.toml에 로컬로 저장됩니다.
uv sync --extra dev
uv run ruff format --check .
uv run ruff check ...
리포지토리 및 문서화 컨벤션은 AGENTS.md에 있습니다.