概要

OpenAI Harmony は、gpt-ossモデルシリーズのための 統一レスポンスフォーマット。 Python と Rust 両方の実装を提供し、高速で一貫したフォーマット処理を実現。 API利用時は 自動でフォーマット されるが、独自推論実装時は harmony形式必須。 開発・テスト環境 のセットアップ方法やコントリビュート手順も網羅。 機能拡張性 と 構造化出力 を重視した設計。

OpenAI Harmony概要

• gpt-ossモデル 専用のレスポンスフォーマット
• 会話構造・推論出力・関数呼び出し を一貫して管理
• OpenAI Responses API 互換設計
• 複数チャンネル出力 （chain of thought、tool calling、通常応答）対応
• 命令階層 と ツールネームスペース 指定機能

利用時のポイント

• API経由 （HuggingFace、Ollama、vLLMなど）では フォーマット自動管理
• 独自推論環境 構築時は harmony形式 の厳守が必要
• harmony形式未使用 ではgpt-ossは 正常動作不可

Pythonでの利用方法

• PyPI からインストール：
  • pip install openai-harmony
• 主要クラス/関数
  • load_harmony_encoding, HarmonyEncodingName, Role, Message, Conversation
• 会話レンダリング例
  • 会話履歴をトークン列に変換し、モデル応答後に パース 可能
• ドキュメント と 型ヒント も充実

Rustでの利用方法

• Cargo.toml に依存追加：
  • openai-harmony = { git = "https://github.com/openai/harmony" }
• 主要構造体/関数
  • Message, Role, Conversation, load_harmony_encoding
• 会話レンダリング と パース をRustコードで実装可能

開発・コントリビュートガイド

• Rustコア と Pythonラッパー の二層構造
  • Rust： チャット/エンコーディングロジック、トークナイザー
  • Python： dataclasses、ラッパーAPI
• ローカル開発手順
  • Rustツールチェーン・Python3.8以上・maturinの準備
  • 仮想環境作成、依存インストール、maturinでビルド
  • RustとPython両方の テストスイート で動作検証
• 型チェック・フォーマット
  • Python：mypy、ruff
  • Rust：cargo fmt

ディレクトリ構成

• src/：Rustクレート本体
  • chat.rs：会話データ構造
  • encoding.rs：レンダリング・パース実装
  • tests.rs：Rustテスト
  • py_module.rs：PyO3バインディング
• harmony/：Pythonラッパー
  • __init__.py：dataclassesとAPI
  • tests/：Pythonテスト
• ルート：Cargo.toml、pyproject.toml、README.md

まとめ

• OpenAI Harmony はgpt-ossモデルのための 高速・一貫フォーマット基盤
• Python/Rust両対応 で幅広い開発スタイルに最適
• 独自推論実装時は必須技術、API経由では自動化
• 開発・テスト・型チェック のガイドも明快