PyCoach

The private, offline-first Python mentor that explains mistakes — not just flags them.

⬇ Download the complete Persian bundle · Windows standalone · Source code

---

See the learning loop

Analyze → Understand → Get a hint → Preview → Fix safely

PyCoach is made for the moment when a beginner knows something is wrong but does not yet know what question to ask. It connects related mistakes, explains the Python rule, and keeps every automatic edit reviewable.

Try it in under a minute: download the bundle, extract it, run START-PYCOACH.cmd, and install the included VS Code extension.

Why it feels different

Most linters stop at “there is an error.” PyCoach continues:

1. What happened? Finds the error and its likely root cause.
2. Why did it happen? Explains the Python rule in beginner-friendly language.
3. What should I try? Reveals progressive hints instead of dumping the answer.
4. Can it be fixed safely? Shows a complete preview before changing code.
5. Did it work? Saves and analyzes the file again.

# Before
four number in [1, 2, 3]
    print(number)

# After Fix All Safe
for number in [1, 2, 3]:
    print(number)

If PyCoach cannot prove a complete fix, it offers a Guided Fix instead of applying a risky partial patch.

Features at a glance

Capability	What you get
🧠 Progressive teaching	Hint 1 → Hint 2 → Example → Preview → Explanation
🛠️ Fix All Safe	Preview, overlap checks, source preconditions and atomic apply
🔎 Function intelligence	Function typos, undefined calls, argument counts and keyword mistakes
🧩 Syntax recovery	Missing colons and conservative corrections such as four → for
🗂️ Project analysis	Import graphs, circular imports, evidence and root-cause hypotheses
📚 Library awareness	Requests, NumPy, Pandas, Matplotlib, FastAPI and Pytest
🎓 Learning controls	Learner level, tutor mode, hint depth and integrity policies
🔐 Local-first	Localhost only, no telemetry, no cloud requirement
📦 Ready on Windows	Private Python 3.12 runtime included

Install in 3 steps

Windows + VS Code

1. Download and extract pycoach-windows-x64-self-contained-0.3.0.zip.
2. Double-click START-PYCOACH.cmd and keep its window open.
3. In VS Code select Extensions → … → Install from VSIX..., then choose pycoach-vscode-0.3.0.vsix.

Open a Python file and run PyCoach: Analyze Current File from the Command Palette. Other commands include:

• PyCoach: Next Hint for Current Diagnostic
• PyCoach: Show Fix Guidance
• PyCoach: Preview and Fix All Safe
• PyCoach: Analyze Python Project
• PyCoach: Browse Root-Cause Evidence

Thonny

Download thonny_pycoach-0.3.0-py3-none-any.whl, then choose Tools → Manage packages → Install from local file. Restart Thonny, start the PyCoach backend, and use Tools → PyCoach: Analyze.

The JetBrains/PyCharm client source is included for contributors, but a verified installable PyCharm binary is not advertised in this release.

How PyCoach teaches

flowchart LR
    A[Your Python file] --> B[Local deterministic analysis]
    B --> C{Confidence}
    C -->|High| D[Preview safe edit]
    C -->|Uncertain| E[Guided fix]
    D --> F[Your confirmation]
    F --> G[Atomic apply]
    G --> H[Analyze again]
    E --> I[Hints and explanation]

Loading

Privacy by design

• Analysis runs locally and binds to 127.0.0.1.
• No telemetry is collected.
• Your code is not sent to a cloud service.
• Ollama integration is optional and disabled by default.
• Logs stay on your computer and avoid raw source code.

Release contents

Download	Best for
Complete Persian bundle	New users who want everything together
Windows standalone	Running without installing Python
VS Code extension	VS Code integration
Thonny plugin	Thonny integration
Complete source archive	Developers and contributors
SHA-256 checksums	Verifying downloads

Quality snapshot

• 68 backend tests passed
• Ruff clean
• TypeScript type-check and compile passed
• VS Code VSIX installation tested in isolation
• Backend and Thonny wheels smoke-imported
• Exact Windows ZIP tested from a fresh Persian-and-spaces path without system Python

---

Learn the error. Own the fix.

If PyCoach helps you learn, consider starring the repository — it helps other beginners discover it.