Open GenAI Stack
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. ```python 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](https://ogx-ai.github.io/docs/api-openai)) - **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](https://www.openresponses.org/) conformant** — the Responses API implementation passes the Open Responses conformance test suite - **Multi-SDK support** — use the [Anthropic SDK](https://docs.anthropic.com/en/api/messages) (`/v1/messages`) or [Google GenAI SDK](https://ai.google.dev/gemini-api/docs/interactions) (`/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](https://ogx-ai.github.io/docs/providers) for the full list. ## Get started Install and run a OGX server: ```bash # 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](https://github.com/openai/openai-python), [TypeScript](https://github.com/openai/openai-node), [curl](https://platform.openai.com/docs/api-reference), or any framework that speaks these APIs. See the [Quick Start guide](https://ogx-ai.github.io/docs/getting_started/quickstart) for detailed setup. ## Resources - [Documentation](https://ogx-ai.github.io/docs) — full reference - [OpenAI API Compatibility](https://ogx-ai.github.io/docs/api-openai) — endpoint coverage and provider matrix - [Getting Started Notebook](./docs/getting_started.ipynb) — text and vision inference walkthrough - [Contributing](CONTRIBUTING.md) — how to contribute **Client SDKs:** OGX provides official client SDKs for Python and TypeScript: | Language | SDK | Package | | :----: | :----: | :----: | | Python | [ogx-client-python](https://github.com/ogx-ai/ogx-client-python) | [](https://pypi.org/project/ogx_client/) | | TypeScript | [ogx-client-typescript](https://github.com/ogx-ai/ogx-client-typescript) | [](https://npmjs.org/package/ogx-client) | ## Community We hold regular community calls every Thursday at 09:00 AM PST — see the [Community Event on Discord](https://discord.gg/bUYRqEvK6) for details. Thanks to all our amazing contributors!
No open issues yet, or sync has not completed.