Skip to content
Open Telureo

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.

  • 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.
  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:

    Terminal window
    export EDU_API_URL=https://staging.telureo.com

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

  3. Create your agency’s account. It’s where your agency works on Telureo: approving tutors, adding credit, and following its scores. Run:

    Terminal window
    edu miner signup

    It signs with your hotkey and the coldkey that owns it, which proves the agency is yours, and prints a link that works once, for 30 minutes. Open it, then give an email, confirmed with a 6-digit code, and a password. Nothing else is asked. Your agency starts with 5 free credits, once. From then on you sign in on the website like anyone else, and the website never asks for a wallet to know the agency is yours. To add another agency to the same account, run the command with its wallet and open the link while you’re signed in. If you ever lose the email, run the command again, and the link moves the agency to a new account.

  4. Set your public profile in your dashboard’s Profile: a name (up to 40 characters, unique), a short description (up to 200), and an https:// logo link. Tutors choose an agency by its name, so without one your agency isn’t listed. The command line works too:

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

Tutors find your agency by its name and ask to join. Their requests appear under Tutors in your dashboard, with each tutor’s name, subjects, and LinkedIn profile. Press Approve or Decline. A request stays open for 7 days.

You can answer from the command line instead. List the requests, then approve one with your coldkey and hotkey:

Terminal window
edu miner requests
edu miner authorize --code ABCD-EFGH

Signing isn’t a transaction, and it can’t move funds.

Your agency’s credit is counted in credits, 10 per TAO, so each credit costs 0.1 TAO. That rate never changes. Each lecture your tutors book uses 1 credit, so booking stays open to real teaching and closed to spam. The price of a booking may grow one day, but your credits stay the same. A credit isn’t refunded if the lecture is cancelled. Without credits, your tutors can’t book.

  1. Open Credit in your dashboard and connect Talisman, or another Polkadot wallet. Any account with TAO can pay. It doesn’t have to hold your agency’s keys.
  2. Choose how many credits to buy, such as 10 credits for 1 TAO, then buy them. Your wallet shows one transaction: the TAO to Telureo’s credit treasury, and a note naming your agency (telureo-credit: and your hotkey).

That’s all. As soon as your wallet approves, the page tells us about the transfer, before it’s sent. So you can close the page whenever you like: we find the transfer on the chain and add the credits once it’s final, usually within a minute. If the page stays open, it shows when they’re added. The note is what makes the credits yours, whichever wallet pays, so nobody can claim your transfer for another agency. Each transfer counts once.

Add credit only from your dashboard. TAO sent to the treasury another way, such as with btcli or from an exchange, has no note, so it counts only once the Telureo team has checked it on the chain and added it by hand.

Credits pay for bookings only. They can’t be withdrawn or turned back into TAO.

Your dashboard has it all: your tutors and the tutors asking to join, your credit, your scores, and your profile. Remove a tutor under Tutors, and close or reopen the agency under Settings. The commands do the same from a terminal:

Terminal window
edu miner signup # a link to your agency's account (needs your coldkey)
edu miner requests # tutors asking to join, with their codes
edu miner tutors # your tutors (up to 5)
edu miner report # your agency's scores and lectures (--json for everything)
edu miner credit # your credits and your latest top-ups (add credit in the dashboard)
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.

  • Up to 5 tutors per hotkey. One coldkey may own several miner and validator hotkeys, and each hotkey has one role.
  • A tutor can make at most 3 requests to join a day (UTC), and each stays open for 7 days.
  • Each booking uses 1 credit of your agency’s credit (10 credits per TAO). A used credit is never refunded, whatever the reason the lecture is cancelled, and it doesn’t move when a tutor switches agency.
  • 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.
  • Closing your agency from Settings releases all its tutors at once. They can join another agency straight away, and their booked lectures go with them. No tutor can ask to join until you reopen it, and your credit stays.
  • 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.

Today, agencies earn rewards from the live audience of free lectures. Once enough tutors and learners have joined, Version 2 adds paid 1:1 tutoring and consulting, Telureo’s main source of revenue, powered by the subnet’s incentive mechanism. How agencies are scored for it will be published before it starts. Our final goal is the world’s best AI tutor, which may become a task for miners. The roadmap in the whitepaper explains each step.

Where knowledge finds its purpose. Free live lectures from people who know their subject, for learners aged 13 and over.