TeachMeCoding
Local-first AI coding tutor with personalized roadmaps, lessons, hands-on practice, and execution-backed assessments. 本地 AI 编程老师:生成学习路线和课件,在真实项目中练习,用运行结果辅助测评。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/liangxiao777--teachmecoding)HTML
<a href="/listings/liangxiao777--teachmecoding"><img src="/api/listings/liangxiao777--teachmecoding/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Requirements
- [Node.js](https://nodejs.org/) 24.15.0 - [pnpm](https://pnpm.io/) 11.1.0 - Git and Bash on `PATH`.
Native dependencies (`better-sqlite3` and `node-pty`) need Python 3 and compiler tools when prebuilt binaries are unavailable. The macOS `node-pty` patch always builds from source.
| OS | Native build prerequisites | | --- | --- | | macOS | Python 3 and Xcode Command Line Tools (`xcode-select --install`) | | Linux (Ubuntu/Debian) | `sudo apt-get update && sudo apt-get install -y git bash build-essential python3` |
For coding assessments, install any additional language toolchains you need, such as `rustc`, and make them available on `PATH`. Python assessments require `python3`. The Agent does not automatically install missing toolchains.
Install and run
Download `teach-me-coding-0.2.0.tar.gz` and `SHA256SUMS` from [GitHub Releases](https://github.com/liangxiao777/TeachMeCoding/releases/tag/v0.2.0). The same archive works on both supported platforms: it contains prebuilt server and frontend assets, but not Node.js or dependencies. Install the prerequisites above and reopen your terminal so the updated `PATH` takes effect.
npm install --global pnpm@11.1.0 tar -xzf teach-me-coding-0.2.0.tar.gz cd teach-me-coding-0.2.0 pnpm install --frozen-lockfile pnpm start
Verify the downloaded archive with `shasum -a 256 -c SHA256SUMS` on macOS or `sha256sum -c SHA256SUMS` on Linux before extracting it.
To build from source instead:
git clone https://github.com/liangxiao777/TeachMeCoding.git cd TeachMeCoding pnpm install --frozen-lockfile pnpm build pnpm start
Open <http://127.0.0.1:4310>. For development from a source checkout, use `pnpm dev` instead (frontend at <http://127.0.0.1:5173>); see the [development guide](docs/development.md).
Configure a model
Open **Settings → Model configuration** and choose a provider, model, and sign-in method. Credentials are stored only in the local data directory (default: `~/.teach-me-coding/`) and are never sent back to the browser.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 172 lines
- <p align="center">
- <img src="apps/web/public/icon.svg" width="80" alt="TeachMeCoding logo" />
- </p>
- <h1 align="center">TeachMeCoding</h1>
- <p align="center">
- English · <a href="README.zh.md">简体中文</a>
- </p>
- <p align="center">
- An AI coding tutor that runs locally: turn learning goals into a roadmap and lessons, practice in real projects, and get assessed using real execution results.
- </p>
- <p align="center">
- <a href="LICENSE"><img alt="License Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-blue" /></a>
- <img alt="Node 24.15" src="https://img.shields.io/badge/node-24.15-339933?logo=node.js&logoColor=white" />
- <img alt="pnpm 11.1" src="https://img.shields.io/badge/pnpm-11.1-F69220?logo=pnpm&logoColor=white" />
- <img alt="Platform macOS, Linux" src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey" />
- <img alt="Status alpha" src="https://img.shields.io/badge/status-alpha-orange" />
- </p>
- <p align="center">
- <a href="#quick-start">Quick start</a> ·
- <a href="#documentation">Documentation</a> ·
- <a href="CONTRIBUTING.md">Contributing</a> ·
- <a href="SECURITY.md">Security</a>
- </p>
- 
- TeachMeCoding creates a separate learning space for each learning goal. The teaching agent clarifies your needs, plans a learning roadmap, and writes lessons. You practice in the built-in IDE and local terminal, and coding submissions run on your machine before the model evaluates the results. All data is stored locally in SQLite and project directories, and the entire application runs in a single Node process.
- > [!WARNING]
- > The agent can read files, run Bash commands, and access the network with the permissions of the system account running the server. It is **not a sandbox**. Run it only in an environment where you trust the model, tools, and reference materials. See [SECURITY.md](SECURITY.md).
- ## Contents
- - [Features](#features)
- - [Project status](#project-status)
- - [Quick start](#quick-start)
- - [Usage](#usage)
- - [Configuration](#configuration)
- - [Documentation](#documentation)
- - [Contributing](#contributing)
- - [Acknowledgments](#acknowledgments)
- - [License](#license)
- ## Features
- - **A complete learning workflow**: clarify your needs → plan a roadmap → study lessons and practice coding → receive assessments and feedback.
- - **An adaptable learning roadmap**: organized into stages and units, with units unlocking in order once lessons for preceding units are ready.
- - **Real projects and terminals**: each learning space has a project directory on disk. The editor saves as you type, and the terminal is a real shell.
- - **Assessments backed by execution evidence**: coding submissions run locally and their output is checked, with support for Python, JavaScript, TypeScript, Rust, and Bash.
- - **Approve changes before they take effect**: roadmap adjustments, lesson rewrites, file edits, and learning conclusions are presented as proposals. You can also enable YOLO mode per conversation to accept them automatically.
- - **Multiple model providers**: connect through [Pi](https://github.com/earendil-works/pi), with API key or OAuth sign-in and visible context usage.
- - **Reference library**: upload reference materials in any format for the agent to read as needed.
- - **Web access**: 14 optional search services (including DuckDuckGo, which requires no API key), plus built-in web fetching.
- - **MCP and Skills**: add MCP servers in Settings, and browse and install Skills from [skills.sh](https://skills.sh).
- - **English and Simplified Chinese interfaces**, with light and dark themes.
- <table>
- <tr>
- <td><img src="docs/images/lesson-en.png" alt="Unit page showing a saved lesson in the demo learning space" /></td>
- <td><img src="docs/images/ide-fullscreen-en.png" alt="Full-screen IDE with a code editor and local terminal" /></td>
- </tr>
- <tr>
- <td align="center">Lessons and coding practice</td>
- <td align="center">Full-screen IDE and local terminal</td>
- </tr>
- </table>
- <sub>Screenshots show an isolated, locally running demo learning space with English demo content, not a live model run.</sub>
- ## Project status
- Version **0.2.0** is an early release. Features, interfaces, and data formats may change.
- Supports **macOS and Linux (Ubuntu/Debian) only**; Windows is unsupported.
- Local verification with Node 24.15.0 covers installation, type checks, build, tests, and SQLite/PTY checks on **macOS 26 / arm64** and in a non-root **Debian 12 / arm64 Docker** environment. macOS also has Google Chrome browser execution coverage. Linux browser checks are **x86_64-only**; Linux arm64 has backend/native verification only. Intel Macs remain unverified. See the [development guide](docs/development.md#testing) for test commands and CI coverage.
- ## Quick start
- ### Requirements
- - [Node.js](https://nodejs.org/) 24.15.0
- - [pnpm](https://pnpm.io/) 11.1.0
- - Git and Bash on `PATH`.
- Native dependencies (`better-sqlite3` and `node-pty`) need Python 3 and compiler tools when prebuilt binaries are unavailable. The macOS `node-pty` patch always builds from source.
- | OS | Native build prerequisites |
- | --- | --- |
- | macOS | Python 3 and Xcode Command Line Tools (`xcode-select --install`) |
- | Linux (Ubuntu/Debian) | `sudo apt-get update && sudo apt-get install -y git bash build-essential python3` |
- For coding assessments, install any additional language toolchains you need, such as `rustc`, and make them available on `PATH`. Python assessments require `python3`. The Agent does not automatically install missing toolchains.
- ### Install and run
- Download `teach-me-coding-0.2.0.tar.gz` and `SHA256SUMS` from [GitHub Releases](https://github.com/liangxiao777/TeachMeCoding/releases/tag/v0.2.0). The same archive works on both supported platforms: it contains prebuilt server and frontend assets, but not Node.js or dependencies. Install the prerequisites above and reopen your terminal so the updated `PATH` takes effect.
- ```sh
- npm install --global pnpm@11.1.0
- tar -xzf teach-me-coding-0.2.0.tar.gz
- cd teach-me-coding-0.2.0
- pnpm install --frozen-lockfile
- pnpm start
- ```
- Verify the downloaded archive with `shasum -a 256 -c SHA256SUMS` on macOS or `sha256sum -c SHA256SUMS` on Linux before extracting it.
- To build from source instead:
- ```sh
- git clone https://github.com/liangxiao777/TeachMeCoding.git
- cd TeachMeCoding
- pnpm install --frozen-lockfile
- pnpm build
- pnpm start
- ```
- Open <http://127.0.0.1:4310>. For development from a source checkout, use `pnpm dev` instead (frontend at <http://127.0.0.1:5173>); see the [development guide](docs/development.md).
- ### Configure a model
- Open **Settings → Model configuration** and choose a provider, model, and sign-in method. Credentials are stored only in the local data directory (default: `~/.teach-me-coding/`) and are never sent back to the browser.
- ## Usage
- 1. Describe what you want to learn on the home page, for example: “I want to learn Rust and build a command-line tool.”
- 2. Answer the agent's questions about your background, goals, and schedule, then confirm the requirements summary.
- 3. Review the generated learning roadmap and ask the agent to adjust it if needed.
- 4. Work through each unit's lessons, practice in the IDE and terminal, and ask the agent questions whenever you need help.
- 5. Complete the assessments and use the feedback to guide your next steps.
- ## Configuration
- - **Startup options** (data directory, port, listen address, and more) are set through environment variables or a `.env` file in the project root. See [`.env.example`](.env.example).
- - **Models, search, MCP, and Skills** are managed in the application's **Settings** page.
- By default, the server listens only on `127.0.0.1`. Set `HOST=0.0.0.0` to allow access over your local network, but **there is no login authentication**. Use this only on a trusted network.
- See the [configuration guide](docs/configuration.md) for all options, the data directory layout, and backup instructions.
- ## Documentation
- - [Configuration](docs/configuration.md): startup options, models, data directory and backups, local network access, search, web fetching, MCP, and Skills
- - [Architecture](docs/architecture.md): components, agent scenarios and tools, proposals and YOLO mode, run lifecycle, and local execution boundaries
- - [Development guide](docs/development.md): development environment, project structure, and tests
- - [UI translation](docs/translating.md): translation conventions and checks
- - [Contributing](CONTRIBUTING.md): issue reporting and the pull request process
- - [Security policy](SECURITY.md): security model and vulnerability reporting
- ## Contributing
- Bug reports and suggestions are welcome through [Issues](https://github.com/liangxiao777/TeachMeCoding/issues). Please read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting a pull request.
- ## Acknowledgments
- - [Pi](https://github.com/earendil-works/pi): agent core, model integration, MCP client, and Skills loading
- - [AI Elements](https://ai-sdk.dev/elements) and [shadcn/ui](https://ui.shadcn.com/): conversation and input components
- - [OpenClaw](https://github.com/openclaw/openclaw): reference implementation for search and web fetching tools
- - [Skills CLI](https://github.com/vercel-labs/skills) and [skills.sh](https://skills.sh)
- - [xterm.js](https://xtermjs.org/), [node-pty](https://github.com/microsoft/node-pty), [better-sqlite3](https://github.com/WiseLibs/better-sqlite3), [Hono](https://hono.dev/), [CodeMirror](https://codemirror.net/)
- ## License
- This project is open source under the [Apache License 2.0](LICENSE).
- Copyright 2026 lxiao ([@liangxiao777](https://github.com/liangxiao777))
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.