Skip to main content
Before contributing to Phaseo, it’s important to understand the layout of the repository. The project is designed for clarity and scalability - separating data, documentation, and app logic so you can easily find what you need.

​
Overview

Here’s what the root directory of the repository looks like:

​
Data folders

Phaseo stores its structured data in JSON files under the /packages/data/catalog/src/data directory. These files act as the source of truth for models, benchmarks, and pricing.

​
/packages/data/catalog/src/data/models

Contains one JSON file per model. Each file describes the model’s metadata, pricing, benchmarks, and capabilities. Example: /packages/data/catalog/src/data/models/openai/gpt-5-2025-08-07/model.json

​
/packages/data/catalog/src/data/organisations

Describes companies or research groups behind models. Each JSON file includes name, description, founding date, website, and country. Example: /packages/data/catalog/src/data/organisations/openai.json

​
/packages/data/catalog/src/data/benchmarks

Contains benchmark metadata and aggregated results across models. Each benchmark has an ID, name, description, category, and metrics. Example: /packages/data/catalog/src/data/benchmarks/mmlu.json

​
/packages/data/catalog/src/data/api_providers

Lists all supported API providers with their supported models. This links to both models and organisations. Example: /packages/data/catalog/src/data/api_providers/openai.json

​
/packages/data/catalog/src/data/pricing

Tracks historical pricing data over time for trend analysis. Files are timestamped and often aggregated by provider.

​
Documentation folders

Documentation is written in MDX and lives in /apps/docs/v1/. Each folder maps directly to a group in the Mintlify configuration.

​
Application folders

Each app runs independently but shares types and configuration through /packages.

​
SDK packages

The /packages directory contains SDKs for various programming languages to interact with the Phaseo API.

​
Automation and scripts

Phaseo uses automation to keep data up to date:
  • Importers - pull new data from sources like Hugging Face or provider APIs.
  • Watchers - run on a schedule (via GitHub Actions) to detect and commit updates.
  • Utilities - handle validation, schema checking, and JSON formatting.
You can explore these under /scripts/.

​
Where to start

If you’re contributing:
  • Data: Look in /packages/data/catalog/src/data/ for JSON files.
  • Documentation: Look in /apps/docs/v1/ for MDX files.
  • Code: Explore /apps/web or /apps/api.
  • Automation: Modify or inspect /scripts/.
  • SDKs: Check /packages/ for language-specific SDKs.

Editing a Model

Learn how to update or add model data.

Editing an Organisation

Understand how to modify organization data safely.
Last modified on July 26, 2026