openresponses  by openresponses

Specification for interoperable LLM interfaces

Created 1 week ago

New!

688 stars

Top 49.6% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Open Responses addresses the critical need for interoperability in the rapidly evolving LLM landscape by defining an open-source specification for multi-provider interfaces. Inspired by the OpenAI API, it standardizes structured request/response models, tool invocation patterns, and semantic streaming capabilities. This enables developers to build consistent, provider-agnostic LLM applications, simplifying integration and enhancing user experience through predictable interactions.

How It Works

The specification's core innovation lies in its agentic loop design, empowering LLMs to emit tool calls, receive structured results, and continue processing iteratively. It introduces "items" as atomic units of context, complete with defined state machines and streaming updates. Crucially, it mandates semantic streaming events rather than raw text deltas, ensuring predictable, provider-agnostic client behavior and facilitating extensibility for provider-specific tools without compromising the core schema's integrity.

Quick Start & Requirements

This repository primarily serves as the specification's definition, containing the OpenAPI schema (public/openapi/openapi.json) and website documentation source (src/pages). The provided README snippet does not detail installation procedures, specific dependencies (e.g., Python versions, hardware requirements), or direct execution commands for implementing or testing the specification.

Highlighted Details

  • Provides a standardized request/response model and streaming semantics, drawing parallels with the established OpenAI API.
  • Supports a robust agentic loop, enabling LLMs to dynamically invoke tools, process their outputs, and manage conversational state.
  • Employs "semantic streaming events" to deliver structured, meaningful updates, enhancing client predictability and reliability over raw text streams.
  • Engineered for extensibility, allowing seamless integration of provider-specific tools and custom item types while adhering to the core schema.

Maintenance & Community

The provided README snippet offers no insights into the project's maintenance status, key contributors, community engagement channels (such as Discord or Slack), or future development roadmaps.

Licensing & Compatibility

The specific open-source license governing this specification is not mentioned in the provided text. Consequently, definitive statements regarding its compatibility for commercial use, integration within closed-source projects, or potential copyleft implications cannot be made.

Limitations & Caveats

The current description focuses exclusively on the specification's conceptual framework and design goals. Information pertaining to practical implementation status, specific technical limitations, identified bugs, performance benchmarks, or the project's maturity level (e.g., alpha, beta) is absent from the provided snippet.

Health Check
Last Commit

6 days ago

Responsiveness

Inactive

Pull Requests (30d)
14
Issues (30d)
17
Star History
692 stars in the last 12 days

Explore Similar Projects

Feedback? Help us improve.