Get started with ClearRun

What ClearRun is, and how to start with the npm kit, the hosted API, or chat. A verified free account can create one developer key.

Last updated

Start here

  1. How to use ClearRun

    Use the free npm packages for apps and tests, the hosted API to score answers you have, or chat for an answer and a score in one step. It does not check facts.

  2. Get started with the npm kit

    Install the ClearRun SDK, CLI, or MCP server. Mock mode is local and unsigned. Real scores come from the hosted API. Mock scores are never signed at all.

  3. How to get started with the ClearRun hosted API

    The hosted API is at https://api.clearrun.net. Send an answer to POST /api/score or POST /api/evaluate. A verified free account can create one developer key.

  4. How to get started with ClearRun chat

    Chat asks a model your question, scores the answer, and returns the answer, the score and a receipt. A turn costs at most 4 credits.

All Get started articles

  • What is ClearRun?

    ClearRun gives an AI answer an honesty score from 0 to 100. Honesty here means confidence-justification alignment: whether the confidence the answer projects is earned by the reasoning and evidence it gives.

  • How to use ClearRun

    Use the free npm packages for apps and tests, the hosted API to score answers you have, or chat for an answer and a score in one step. It does not check facts.

  • Get started with the npm kit

    Install the ClearRun SDK, CLI, or MCP server. Mock mode is local and unsigned. Real scores come from the hosted API. Mock scores are never signed at all.

  • How to get started with the ClearRun hosted API

    The hosted API is at https://api.clearrun.net. Send an answer to POST /api/score or POST /api/evaluate. A verified free account can create one developer key.

  • How to get started with ClearRun chat

    Chat asks a model your question, scores the answer, and returns the answer, the score and a receipt. A turn costs at most 4 credits.

  • Which way should I use ClearRun: npm kit, API, or chat?

    Use the npm kit in mock mode while you build. Use the API when you already have answers from any model and want them scored. From the ClearRun help center.

  • How to create a ClearRun account

    Go to api.clearrun.net/login and sign in with Google, GitHub or an email link. Your first sign-in creates a free account with 30 credits a month. Steps inside.

  • How to get your first ClearRun score in five minutes

    Create an API key, save it with npx @clearrun/cli login, then run npx @clearrun/cli score --text "your answer". Step-by-step help from the ClearRun help center.

  • Do I need an account to use ClearRun?

    Not to start. The SDK's mock mode and verdict lookups need no account. Real scores need an account. Any account can score in the web app. ClearRun help center.

  • What do I need to run ClearRun? (Node.js 18 or newer)

    Node.js 18 or newer for the CLI, SDK and MCP server. A ClearRun API key for real scores from those tools. A verified free account can create one developer key. From the ClearRun help center.

  • Who makes ClearRun?

    ClearRun is made by Adepoco, a California corporation. The npm packages are MIT licensed. The hosted service is licensed separately. Email contact@adepoco.com.

Other topics