Run an agency

On the Telureo subnet, a miner is a tutor agency. Each miner hotkey can authorize up to 5 tutors. The network rewards an agency for the live audience of the lectures its tutors give. So a good agency finds good teachers, agrees fair pay with them, and helps them improve.

What an agency does

• Recruits tutors, and agrees with each one how and when it pays them. Hourly, monthly, or a share of rewards: that’s between the agency and the tutor.
• Helps tutors prepare, reviews how their lectures go, and coaches new ways of teaching.
• Keeps its 5 places filled with tutors who teach well, and replaces them when needed.

Set up

1. Register a hotkey on the Telureo subnet, as for any Bittensor subnet.

2. Install the Telureo command line, edu, from the subnet repository, published at launch (uv sync, then uv run edu …, or pip install .). Every command takes the usual --wallet.name, --wallet.hotkey, and --wallet.path. Point it at Telureo first:

   export EDU_API_URL=https://web-production-eecc0.up.railway.app

   Signed requests are refused when your computer’s clock is more than a minute off, so keep it synchronized.

3. Set your public profile. Give a name (up to 40 characters, unique), a short description (up to 200), and an https:// logo link. Tutors see your profile before they ask to join. Without a name, your agency doesn’t appear in the tutors’ list of agencies.

   edu miner profile --name "Bright Minds" --description "Maths and physics tutors" --logo-url https://…

Authorize tutors

A tutor requests a verification code for your hotkey in their dashboard, and sends it to you. You sign it with your coldkey and hotkey:

edu miner authorize --code ABCD-EFGH

Signing isn’t a transaction, and it can’t move funds. A code names one hotkey, works once, and expires after 1 hour.

Day to day

The commands you’ll use most:

edu miner tutors                       # your tutors (up to 5)
edu miner report                       # your agency's scores and lectures (--json for everything)
edu miner remove --tutor <account-id>  # needs your coldkey
edu status                             # what Telureo knows about your hotkey

To pay tutors on your own schedule, read their scores for any period. Scores for pay shows how.

Rules that affect agencies

• Up to 5 tutors per hotkey. One coldkey may own several miner and validator hotkeys, and each hotkey has one role.
• A tutor can request at most 3 codes a day (UTC).
• One lecture per tutor per day (UTC), 10 to 120 minutes long, and at most 8 at once on each channel. A tutor can cancel only more than 48 hours before the start.
• A lecture counts for the agency it was booked under. A tutor who switches agency (at most once every 7 days) takes their booked lectures to the new agency. Lectures already streamed stay with the old one.
• A tutor who leaves without switching has their booked lectures cancelled, and can’t join an agency for 14 days. A tutor you remove has them cancelled too, and can’t join an agency for 7 days.
• No agency change is possible from 12 hours before a tutor’s lecture until it ends, and on through any next lecture that starts within 12 hours.
• If your hotkey is deregistered, your tutors can switch at once. Lectures streamed for the deregistered registration earn no rewards. They still count in rankings and in /api/scores, marked registered: false.
• We can stop a lecture, or exclude it from scoring, when it breaks the published rules. Each decision is logged with its reason.