Phaseo

Unified AI gateway and model intelligence for teams building with AI APIs.

pnpm add @phaseo/sdk | pip install 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.
`packages/sdk/*`	TypeScript, Python, Go, C#, PHP, Ruby, Java, C++, Rust, and Agent SDK packages.
`packages/data/catalog`	Canonical model, provider, pricing, benchmark, and catalog data.
`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.
SDKs	Available	Public SDK package names, examples, and docs now use Phaseo names across TypeScript, Python, Go, C#, PHP, Ruby, Java, C++, Rust, and Agent SDKs.

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 validate:data
pnpm validate:pricing
pnpm validate:gateway
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, examples, and catalog data. Read CONTRIBUTING.md and CODE_OF_CONDUCT.md before opening a PR.

Security

Report vulnerabilities privately through GitHub Security Advisories or security@phaseo.app.

License

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

phaseo_agent_sdk

Runtime