← プロジェクト一覧に戻る

Helicone

リクエストの経路上に入ってモデル呼び出しを記録するため、コード側に計測を仕込まなくてよい

Apache-2.0
スター
6.1k
フォーク
661
オープンIssue
155
最終コミット
2026年8月26日

Heliconeとは

多くの記録ツールは呼び出しを包むことを求めますが、見たいコードがライブラリの中や別のジョブ、他人が持つサービスの中にあると、その方法は使えません。Helicone は別の道を取ります。接続先のURLを向けるだけで、通過するリクエストがすべて記録され、経路上にSDKは入りません。すでにその位置にいるため、ゲートウェイの仕事も兼ねます。複数の提供元を1つの鍵で扱い、片方が落ちたら自動で切り替え、繰り返しのプロンプトはキャッシュから返します。引き換えはその位置そのものです。アプリケーションとモデルの間にプロキシが入るため、運用する部品と経路が1つ増えます。エージェントの実行はセッションとしてまとまるので、多段の記録が無関係な30件の呼び出しではなく1つのまとまりとして読めます。

Heliconeで何ができますか?

  • 呼び出し側のコードを変えずに記録する — 接続先のURLを変えるだけで導入が済むため、ライブラリの奥や他チームのサービスの中で行われる呼び出しも記録されます。
  • 多段の実行を1つのまとまりとして読む — 関連する呼び出しがセッションにまとまるので、30回要求を出して作業を終えたエージェントが30行ではなく1つの記録として見えます。
  • 提供元が止まっても動き続ける — すでに経路上にいるため、複数の提供元へ振り分け、片方が失敗し始めたら自動的に切り替えられます。
  • 同じプロンプトに二重で払わない — 繰り返しの要求をキャッシュから返せます。毎ターン同じ文脈を送り直すエージェントのループで効いてきます。
  • 記録した通信を評価データにする — 記録した要求を評価や追加学習のために集められます。作り物の例ではなく実際の利用が試験項目になります。
  • データを外に出せないなら自分で動かす — 基盤はオープンソースで自社運用できます。プロンプトに社外へ出せない内容が含まれる場合、ここが決め手になります。

Heliconeを選ぶ前に

  • 経路上のプロキシは運用対象が1つ増え、すべての呼び出しに1経路加わることを意味します。それを受け入れる理由は、手を入れられないコードまで記録できる点にあります。
  • 基盤一式を自社で動かすのは、記録用ライブラリを足すより重い作業です。読み込むパッケージではなく、自前のデータ保存先を伴うWebアプリケーションだからです。

よくある質問

Heliconeは商用利用できますか?

HeliconeはApache-2.0ライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。

Heliconeはどの形で使えますか?

Heliconeはセルフホスト・マネージドクラウド・ローカル実行の形で利用できます。

ドキュメント

Helicone/helicone のREADMEより転載(Apache-2.0)。 原文を読む ↗

🔍 Observability🕸️ Agent Tracing🚂 LLM Routing
💰 Cost & Latency Tracking📚 Datasets & Fine-tuning🎛️ Automatic Fallbacks

Helicone is an AI Gateway & LLM Observability Platform for AI Engineers

  • 🌐 AI Gateway: Access 100+ AI models with 1 API key through the OpenAI API with intelligent routing and automatic fallbacks. Get started in 2 minutes.
  • 🔌 Quick integration: One-line of code to log all your requests from OpenAI, Anthropic, LangChain, Gemini, Vercel AI SDK, and more.
  • 📊 Observe: Inspect and debug traces & sessions for agents, chatbots, document processing pipelines, and more
  • 📈 Analyze: Track metrics like cost, latency, quality, and more. Export to PostHog in one-line for custom dashboards
  • 🎮 Playground: Rapidly test and iterate on prompts, sessions and traces in our UI.
  • 🧠 Prompt Management: Version prompts using production data. Deploy prompts through the AI Gateway without code changes. Your prompts remain under your control, always accessible.
  • 🎛️ Fine-tune: Fine-tune with one of our fine-tuning partners: OpenPipe or Autonomi (more coming soon)
  • 🛡️ Enterprise Ready: SOC 2 and GDPR compliant

🎁 Generous monthly free tier (10k requests/month) - No credit card required!

Quick Start ⚡️

  1. Get your API key by signing up here and add credits at helicone.ai/credits

  2. Update the baseURL in your code and add your API key.

    import OpenAI from "openai";
    
    const client = new OpenAI({
      baseURL: "https://ai-gateway.helicone.ai",
      apiKey: process.env.HELICONE_API_KEY,
    });
    
    const response = await client.chat.completions.create({
      model: "gpt-4o-mini",  // claude-sonnet-4, gemini-2.0-flash or any model from https://www.helicone.ai/models
      messages: [{ role: "user", content: "Hello!" }]
    });
  3. 🎉 You’re all set! View your logs at Helicone and access 100+ models through one API.

Self-Hosting Open Source LLM Observability

Docker

Helicone is simple to self-host and update. To get started locally, just use our docker-compose file.

# Clone the repository
git clone https://github.com/Helicone/helicone.git
cd docker
cp .env.example .env

# Start the services
./helicone-compose.sh helicone up

Helm

For Enterprise workloads, we also have a production-ready Helm chart available. To access, contact us at enterprise@helicone.ai.

Manual deployment is not recommended. Please use Docker or Helm. If you must, follow the instructions here.

Architecture

Helicone is comprised of five services:

  • Web: Frontend Platform (NextJS)
  • Worker: Proxy Logging (Cloudflare Workers)
  • Jawn: Dedicated Server for serving collecting logs (Express + Tsoa)
  • Supabase: Application Database and Auth
  • ClickHouse: Analytics Database
  • Minio: Object Storage for logs.

Integrations 🔌

Inference Providers

IntegrationSupportsDescription
AI GatewayJS/TS, Python, cURLUnified API for 100+ providers with intelligent routing, automatic fallbacks, and unified observability
Async Logging (OpenLLMetry)JS/TS, PythonAsynchronous logging for multiple LLM platforms
OpenAIJS/TS, PythonInference provider
Azure OpenAIJS/TS, PythonInference provider
AnthropicJS/TS, PythonInference provider
OllamaJS/TSRun and use large language models locally
AWS BedrockJS/TSInference provider
Gemini APIJS/TSInference provider
Gemini Vertex AIJS/TSGemini models on Google Cloud’s Vertex AI
Vercel AIJS/TSAI SDK for building AI-powered applications
AnyscaleJS/TS, PythonInference provider
TogetherAIJS/TS, PythonInference provider
HyperbolicJS/TS, PythonInference provider
GroqJS/TS, PythonHigh-performance models
DeepInfraJS/TS, PythonServerless AI inference for various models
Fireworks AIJS/TS, PythonFast inference API for open-source LLMs

Frameworks

FrameworkSupportsDescription
LangChainJS/TS, PythonUse AI Gateway with LangChain for unified provider access
LlamaIndexPythonFramework for building LLM-powered data applications
LangGraphPythonBuild stateful, multi-actor applications with LLMs
Vercel AI SDKJS/TSAI SDK for building AI-powered applications
Semantic KernelC#, PythonMicrosoft’s AI orchestration framework
CrewAIPythonFramework for orchestrating role-playing AI agents
ModelFusionJS/TSAbstraction layer for integrating AI models into JavaScript and TypeScript applications
PostHogJS/TS, Python, cURLProduct analytics platform. Build custom dashboards.
RAGASPythonEvaluation framework for retrieval-augmented generation
Open WebUIJS/TSWeb interface for interacting with local LLMs
MetaGPTYAMLMulti-agent framework
Open DevinDockerAI software engineer
Mem0 EmbedChainPythonFramework for building RAG applications
DifyNo code requiredLLMOps platform for AI-native application development

This list may be out of date. Don’t see your provider or framework? Check out the latest integrations in our docs. If not found there, request a new integration by contacting help@helicone.ai.

Additional Resources

For more information, visit our documentation.