Phaseo

Phaseo combines a production AI gateway with the model, provider, pricing, benchmark, and reliability data teams need when choosing what to run in production.

Use it to:

• route requests through one OpenAI-compatible API;
• compare model quality, price, latency, throughput, and provider coverage;
• observe spend and reliability across teams and apps;
• build against SDKs, management APIs, and routing controls from one repo.

Why Phaseo

Choosing an AI model is no longer just a leaderboard decision. Production teams need to know which model is available, which provider can serve it, what it costs, how it behaves under load, and how to switch when requirements change.

Phaseo keeps those decisions in one place: the gateway handles requests, while the catalog and dashboard make the tradeoffs visible.

Quickstart

Create an API key at https://phaseo.app, then call the gateway:

curl https://api.phaseo.app/v1/chat/completions \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-nano-2025-08-07",
    "messages": [{"role": "user", "content": "Say hello from Phaseo."}]
  }'

Or use the OpenAI-compatible TypeScript client:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: "https://api.phaseo.app/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5-nano-2025-08-07",
  messages: [{ role: "user", content: "Summarize Phaseo in one sentence." }],
});

console.log(response.choices[0]?.message?.content);

What Is In This Repo

Path	Purpose
apps/web	Next.js product, dashboard, model catalog, gateway UI, blog, and public site.
apps/api	Cloudflare Workers + Hono gateway API.
apps/docs	Mintlify documentation and OpenAPI reference.
apps/desktop	Phaseo Desktop, the Electron workspace for chats, coding agents, projects, Git and a built-in browser.
packages/sdk/*	TypeScript, Python, Go, C#, PHP, Ruby, Java, C++, Rust, and Agent SDK packages.
examples/*	Small apps and smoke projects for gateway and OAuth flows.
scripts/*	Catalog, OpenAPI, release, validation, and maintenance tooling.

Platform Surface

Surface	Status	Notes
Gateway API	Available	OpenAI-compatible endpoints plus Phaseo routing controls.
Model and provider catalog	Available	Model metadata, pricing, providers, capabilities, and benchmark context.
Web dashboard	Available	Usage, keys, routing, apps, settings, model pages, and internal tools.
Docs	Available	Guides, API reference, SDK examples, cookbook, and changelog.
Desktop app	Preview	Chats and coding agents (Phaseo, Claude Code, Codex and more) with projects, Git, terminals and a built-in browser. Build it from apps/desktop.
SDKs	Available	TypeScript, Python, Go, C#, PHP, Ruby, Rust, and Agent SDKs. The Java SDK supports a pinned source install; C++ remains a transport-dependent preview.

Local Development

pnpm install
pnpm --filter @phaseo/web dev
pnpm --filter @phaseo/gateway-api dev
pnpm --filter @phaseo/docs dev

Common checks:

pnpm lint
pnpm typecheck
pnpm docs:build

Resources

• Website: https://phaseo.app
• Docs: https://phaseo.app/docs/v1
• API reference: https://phaseo.app/docs/v1/api-reference/introduction
• Issues: https://github.com/phaseoteam/Phaseo/issues
• Good first issues: https://github.com/phaseoteam/Phaseo/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22
• Discord: https://discord.gg/aQyywCvgZ5

Rebrand Compatibility Note

Phaseo package names and documentation are now the primary public surface. New API keys use the phaseo_v1_sk_... prefix. Existing aistats_... keys remain accepted during the compatibility window and are scheduled to stop working on 1 January 2027.

Contributing

Contributions are welcome across the gateway, web app, docs, SDKs, and examples. Read CONTRIBUTING.md and CODE_OF_CONDUCT.md before opening a PR.

For catalog corrections or missing models, providers, pricing, or benchmark results, open an issue with the affected page and official sources. Maintainers review reports and update the database through the internal editor, which requires admin access.

The database is the catalog source of truth. The admin editor and approved database automations write catalog data directly. The repository holds no catalog JSON or exports.

Security

Report vulnerabilities privately through GitHub Security Advisories or [email protected].

License

• Core apps (apps/web, apps/api, apps/docs) are AGPL-3.0.
• SDKs under packages/sdk/* are MIT.
• Full terms: LICENSE.

Star History