Overview
This guide shows how to run the Content Validator as part of CI in Github so pull requests receive a validation check and a comment with any issues. It makes use of a small python utility, Github actions and the Omni API.
What it does
- Runs the Content Validator API for a model on every PR.
- Posts a PR comment with validation results (screenshot below).
- Stores a history artifact to flag new vs existing issues.
- Supports Omni branches by resolving branch name → branch ID.
Demo
Prerequisites
- Omni API * key with access to the model.
- Model ID to validate (the MCP server docs describe how to get this)
- Access to get * Github Actions for your Omni repo.
Setup
- Add GitHub 1. secrets and variables:
OMNI_API_KEY(secret)OMNI_BASE_URL(variable or secret)OMNI_MODEL_ID(variable or secret)
- Run the workflow once on the default branch to create the initial history artifact.
- Open a PR to see the check + comment.
Links
- GitHub - ernestoongaro/omnicles: CI tooling for Omni.co's Analytics Platform
- API authentication - Omni Docs
- Content Validator Docs
- [coming soon] Content Validator API docs
Notes
- The Content Validator API currently validates all content and does not support filters.
- Optional history helps reduce noise by identifying which issues are newly introduced, use it with the
--fail-on-new-onlyflag (see GH utility README)
Disclaimer
This is community-built and not an official Omni release. Review the code and use at your own risk.
