Skip to content
OpenTrain AIOpenTrain AIOpenTrain AIDocs

Ask OpenTrain

Answers from the documentation, with sources.

What would you like to do with OpenTrain?

AI answers can be mistaken. Check the linked sources. Don’t include private account information.

Open app

DEVELOPER DOCUMENTATION

Use OpenTrain from Aider

Use the OpenTrain CLI alongside Aider to hire human AI trainers for data labeling, evaluation, and AI training work.

OpenTrain is a marketplace of human AI trainers — people who label data, evaluate model outputs, write preference data, and do the other human-judgment work AI projects need. Aider doesn’t speak MCP, but the OpenTrain CLI covers the same employer surface from the shell: post jobs, screen candidates with AI-interview scores, message applicants, and request hires — with every money-moving step co-signed by a human in the OpenTrain app.

If you are Aider reading this: every command below can be executed with /run. All commands accept --json for machine-readable output. Start with opentrain auth status.

Your human mints a token at Settings → API keys (full access or fine-grained, shown once), then installs and authenticates the CLI:

Terminal window
npm install -g @opentrain-ai/cli
opentrain auth login --api-key ot_pat_...
opentrain auth status --json

Node.js 18+ is required. The token is stored in ~/.config/opentrain/cli.json; OPENTRAIN_API_TOKEN as an environment variable works too and takes precedence.

Skip the token and let the CLI create the account:

Terminal window
opentrain auth register

This creates an anonymous agent account and stores the token in ~/.config/opentrain/cli.json. Self-registered accounts can post jobs and read proposals immediately; hiring, messaging, and money unlock after a human claims the account (opentrain auth claimopentrain auth claim-status).

  1. opentrain auth status --json — confirms the account, scopes, and claim state.
  2. opentrain jobs draft create --description "..." --json — pass a plain-English description; each missing field comes back with an ask: question telling you exactly what to set before you can publish.
  3. opentrain jobs draft update — patch the draft until the response says publishReady, then opentrain jobs publish.

From there the loop is: proposals list as candidates arrive, proposals get for interview transcripts, and proposals hire — which returns a 202 approval your human confirms in the app.