# Setup guide — Socratic Tutor Agent

## 1. Install and configure the tutor

Install the agent and choose subject scope.

```
pipx install socratic-tutor-agent
socratic-tutor-agent init --subjects math,science,writing
socratic-tutor-agent doctor
```

## 2. Set integrity and safety guardrails

The no-graded-answers and escalation behaviors are enforced, not optional.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
COMPLETE_GRADED_WORK=false
AGE_APPROPRIATE=true
ESCALATE_ON: [distress, self_harm, safety, out_of_scope]
```

## 3. Tune the pedagogy

Set how much to scaffold before revealing more.

```
# tutor.yml
intervention_order: [guiding_question, hint, analogy, parallel_example]
reveal_full_solution: only_non_graded_or_after_attempts
encouragement: honest_specific   # no empty praise
```

## 4. Pilot with sample problems

Run example sessions and review that it guides rather than answers.

```
socratic-tutor-agent demo --problem ./algebra.txt --explain
# shows interventions chosen + integrity_mode + any escalation
```

## 5. Wire into your learning surface

Embed in your app/LMS with appropriate supervision for minors.

```
# chat surface -> tutor; graded-work requests -> scaffolding; flags -> teacher dashboard
```
