Skip to main content

OGX

PyPI Version PyPI Downloads Docker Hub Pulls License Discord Unit Tests Integration Tests OpenResponses Conformance Ask DeepWiki

Quick Start | Documentation | OpenAI API Compatibility | Discord

[!IMPORTANT] Llama Stack is now OGX. The name changed, and so did the mission — model-agnostic, multi-SDK, production-grade. Read the full announcement →

Open-source agentic API server for building AI applications. OpenAI-compatible. Any model, any infrastructure.

OGX Architecture

OGX is a drop-in replacement for the OpenAI API that you can run anywhere — your laptop, your datacenter, or the cloud. Use any OpenAI-compatible client or agentic framework. Swap between Llama, GPT, Gemini, Mistral, or any model without changing your application code.

from openai import OpenAI

client = OpenAI(base_url="http://localhost:8321/v1", api_key="fake")
response = client.chat.completions.create(
    model="llama-3.3-70b",
    messages=[{"role": "user", "content": "Hello"}],
)

What you get

  • Chat Completions & Embeddings — standard /v1/chat/completions, /v1/completions, and /v1/embeddings endpoints, compatible with any OpenAI client
  • Responses API — server-side agentic orchestration with tool calling, MCP server integration, and built-in file search (RAG) in a single API call (learn more)
  • Vector Stores & Files/v1/vector_stores and /v1/files for managed document storage and search
  • Batches/v1/batches for offline batch processing
  • Skills/v1alpha/skills for managing versioned skill bundles (zip archives with SKILL.md manifests) that agents can invoke
  • Open Responses conformant — the Responses API implementation passes the Open Responses conformance test suite
  • Multi-SDK support — use the Anthropic SDK (/v1/messages) or Google GenAI SDK (/v1alpha/interactions) natively alongside the OpenAI API

Use any model, use any infrastructure

OGX has a pluggable provider architecture. Develop locally with Ollama, deploy to production with vLLM, or connect to a managed service — the API stays the same.

See the provider documentation for the full list.

Get started

Install and run a OGX server:

# One-line install
curl -LsSf https://github.com/ogx-ai/ogx/raw/main/scripts/install.sh | bash

# Or install via uv
uv pip install ogx

# Start the server (auto-detects providers from the environment)
uv run ogx go

Then connect with any OpenAI, Anthropic, or Google GenAI client — Python, TypeScript, curl, or any framework that speaks these APIs.

See the Quick Start guide for detailed setup.

Resources

Client SDKs:

OGX provides official client SDKs for Python and TypeScript:

Language SDK Package
Python ogx-client-python PyPI version
TypeScript ogx-client-typescript NPM version

Alternative Python SDK:

For users who prefer an OpenAPI Generator-based SDK, an alternative Python client is available:

  • ogx-open-client — Auto-generated from OpenAPI spec, provides similar functionality with a different generation approach
  • Usage Examples — End-to-end code examples for all major features
  • Strategy & Rationale — Why two SDKs, when to use which, and long-term plans

The official ogx_client SDK is recommended for most use cases. The ogx_open_client package offers an alternative for teams with specific OpenAPI tooling requirements.

Community

We hold regular community calls every Thursday at 09:00 AM PST — see the Community Event on Discord for details.

Star History Chart

Thanks to all our amazing contributors!

OGX contributors

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ogx-1.3.0.tar.gz (18.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ogx-1.3.0-py3-none-any.whl (814.9 kB view details)

Uploaded Python 3

File details

Details for the file ogx-1.3.0.tar.gz.

File metadata

  • Download URL: ogx-1.3.0.tar.gz
  • Upload date:
  • Size: 18.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for ogx-1.3.0.tar.gz
Algorithm Hash digest
SHA256 cf20a116fc5c93cbd88eed3c6d0d25eb52ca338a53a54b8d3c09917a9391340d
MD5 bc73e3b4c2f44bf467a544ff9b82c61e
BLAKE2b-256 26bd5f8ce11504990bb25336a402acfca48c042f89c101130f63ed07292b8f0e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ogx-1.3.0.tar.gz:

Publisher: pypi.yml on ogx-ai/ogx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ogx-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: ogx-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 814.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for ogx-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e3e1f50afad849ff385e6c1e033d9116346a2166333fd4088fc778fcc9692b0d
MD5 791171a7b92b0e74d040690f495cf90e
BLAKE2b-256 07eaa9490b815f2fd6c91d343ee878891391a2cf2907debd2dac161463e1bb70

See more details on using hashes here.

Provenance

The following attestation bundles were made for ogx-1.3.0-py3-none-any.whl:

Publisher: pypi.yml on ogx-ai/ogx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.3.1

2 files

This release

1.3.0 This release

2 files

1.2.5

2 files

1.2.4

2 files

1.2.3

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.1.3

2 files

1.1.2

2 files

1.1.1

2 files

1.1.0

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

0.8.0

2 files

0.7.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page