> ## Documentation Index
> Fetch the complete documentation index at: https://docs.remyx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Diagnose missing installations, unavailable models, blocked runs, and errors.

## Find why a run stopped

Check the installation, command permissions, selected model, available credits, active run status, and the specific error reported in GitHub.

Use the exact error code and stage from the PR comment or GitHub Check to select a recovery step.

If Validate does not start, check the repository connection, permissions, credits, model selection, and current run state.

## Check the repository

Install the Remyx GitHub App on the repository and connect the installation in Studio. If the installation has not been claimed, complete that step with an authorized GitHub account.

Confirm that Validations are enabled for the installation.

## Check the request

The command must be on an open pull request and submitted by an authorized repository owner, member, or collaborator.

If another validation is running on the repository, read its status before submitting another request.

## Check credits and models

If the free completed run is used, add credits under Studio → Account → Billing. Check whether a supported model is available through your configured provider or an eligible Remyx-funded allowance.

## Read the error

The PR comment and GitHub Check identify the failed stage when available. A timeout, missing metric, insufficient balance, and invalid spec require different fixes.

## Error reference

Use the exact error codes and HTTP statuses below to identify the cause.

| The reply said | Outcome | HTTP | What to do |
| - | - | - | - |
| This repo isn't connected to Remyx yet | `not_connected` | 404 | Install the App on the repo under Connectors → GitHub. |
| The Remyx App is installed, but no account has claimed the installation | `not_connected` | 404 | Connect GitHub from Studio with an account that can reach that GitHub login. |
| Validations are turned off for this repo | `disabled` | 409 | Flip the installation's Validations switch under Connectors → GitHub. |
| Not started, this installation's free validation has been used, and the balance is empty | `gated` | 402 | Add credits under Account → Billing. Nothing was used. |
| Not started, the free run's model allowance is used up | `allowance` | 402 | Add credits or connect a model provider. |
| Not started, Remyx's shared allowance for free runs is used up for today | `allowance` | 402 | Mention again tomorrow, add credits, or connect a provider. |
| This account has more than one model provider connected and no Validate default | `no_model` | 409 | Pick one under Account → Validate. |
| I need a model to design a validation and this account has no provider connected | `no_model` | 409 | Connect one under Connectors → LLM providers. |
| Your connected model key is out of credit / was rejected / is rate-limited | `model_key` | 409 | Top up or reconnect the key, or switch Validate to another provider. |
| This commit is already being validated | `already_running` | 409 | Wait, or push a new commit. |
| Not started, a validation is already running on this repo | `busy` | 409 | Mention again when it finishes. |
| There is no proposal of mine awaiting confirmation to revise | `nothing_to_revise` | 409 | Edit the yaml and mention `validate`, or delete it and ask for a fresh design. |
| Nothing is running | `nothing_running` | 409 | A `cancel` with nothing in flight. |
| This spec logs to W\&B and the account has no W\&B connection | `no_wandb` | 409 | Connect W\&B, or drop the `logging.wandb` block. |
| This doesn't look like a PR I can validate | `not_a_pr` | 400 | The PR has no head commit. |
| I couldn't synthesize a validation for this change | `error` | 502 | Add a `.remyx/validation.yaml` yourself, or try again. |

A refusal at start always says "Nothing was used". It is never charged.

## Next steps

[Run a validation tutorial](https://docs.remyx.ai/tutorials/validate-first-run.md) · [Read the validation spec](https://docs.remyx.ai/platform/agents/validate-spec.md) · [Use the API](https://docs.remyx.ai/api-reference/validate.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.