Struct Teacher 

pub struct Teacher { /* private fields */ }

A source of proposals.

Constructing one is where credentials are checked, so a missing configuration fails before any work is queued rather than part-way through a corpus.

Implementations

impl Teacher

pub fn fixed(proposal: Proposal) -> Teacher

A teacher that returns a fixed proposal. Useful for tests, for replaying a recorded proposal, and for feeding in candidates from a source of your own.

pub fn local( base_url: impl Into<String>, model: impl Into<String>, ) -> Result<Teacher, LearnError>

A teacher backed by a local model behind an OpenAI-compatible endpoint.

This is the preferred route. It needs no credentials, sends nothing off the machine, and costs nothing, which removes every objection to learn except quality. Works with llama.cpp, vLLM, LM Studio, Ollama — anything speaking /v1/chat/completions.

The model must support tool calling. learn asks for a structured ontology, and a model without tool calling replies in prose or with nothing — measured on a local ollama, qwen2.5:0.5b returns tool_calls: null for every request, while qwen3.5:0.8b, granite3-moe:3b and functiongemma work.

Beyond that, a small model is a reasonable choice because of the gate. Proposals are judged by the same deterministic MECE test as local discovery, so a weak model produces rejected candidates rather than a polluted vocabulary. The failure mode of choosing badly is wasted effort, not a wrong answer: on an eight-document corpus qwen3.5:0.8b proposed a category that appears nowhere in the text and one that restated an existing category, and the gate refused both.

use steeldb::learn::Teacher;
// a function-calling model small enough to run on a laptop
let teacher = Teacher::local("http://localhost:11434/v1", "qwen3.5:0.8b")?;

pub fn ollama(model: impl Into<String>) -> Result<Teacher, LearnError>

A teacher backed by a model served by Ollama on the default port.

Shorthand for Teacher::local against http://localhost:11434/v1.

pub fn bedrock(model_id: impl Into<String>) -> Result<Teacher, LearnError>

A teacher backed by Amazon Bedrock.

Requires AWS credentials resolvable by the standard chain (environment, profile, or instance role) and AWS_REGION. Checked here so the failure is immediate and names what is missing.

This costs money per call. The amount is small for vocabulary proposal — one request over a sample of documents — but it is a real charge and worth saying out loud.

pub async fn propose_categories( &self, db: &SteelDb, ) -> Result<Proposal, LearnError>

Ask for categories the local discovery may have missed.

Returns a Proposal; nothing changes until you SteelDb::adopt it.