learnharness README

项目的 README,来自 github.com/amosblomqvist/learnharness。合并为一个 markdown 文件:README.md。

LearnHarness

An agent harness for learning.

Download · How it works · Documentation · Issues · Discord

LearnHarness uses AI agents to plan and teach lessons from your current understanding to your goal. It builds a detailed picture of what you understand and how you reason. That picture is updated as you learn.

Instead of just giving you an explanation, it uses your answers and thinking to decide what you need next. Teaching builds understanding one reasoning step at a time. Practice makes it usable. A persistent knowledge graph carries it across sessions.

LearnHarness teaching session

How it works

  1. Measure. Before teaching, the agent finds where your understanding ends on each part the lesson depends on. Your answers, confidence, and thinking show it where to start.
  2. Plan. It works out a dependency map from that starting point to your goal. You can see the plan, and the lesson adapts when your understanding turns out different.
  3. Teach. Each step builds on something you already understand. You predict, get an explanation, and check your understanding. Confusions are repaired before anything is built on them. The aim is for the goal to feel obviously true, not merely familiar.
  4. Practice. Separate sessions pose varied problems that require the right knowledge to come to mind without being named first. Problems and hints adapt to your reasoning.

Think out loud. The thinking fields let you explain your reasoning, uncertainties, and reactions in your own words. This is how the agent gets a detailed picture rather than just a record of right and wrong answers. You can type or use dictation.

Bring your files. In the desktop app, attach PDFs, photos, or any other file with the paperclip, or drag them in. The file stays where it is: the message carries its path, and the agent reads it from there.

The agent can also research questions in the background, create visual explanations, show your own images in the lesson and mark them up with arrows and labels, and build interactive demonstrations.

Knowledge that carries forward

What you are taught accumulates as propositions and reasoning chains: individual claims and the premises that lead to them. The graph shows this structure, with links back to the source sessions. You can also import notes.

Future teaching sessions can read the graph instead of starting from scratch. Practice sessions can draw their material from it. It stores the ideas and their connections, not ratings of your ability.

LearnHarness knowledge graph

Download and get started

Download from learnharness.ai · GitHub Releases

Choose your models, then start a session with what you want to understand. You can use provider API keys, supported subscription connections in the desktop app, an installed Claude Code CLI, or a custom OpenAI-compatible endpoint, including a local model server. Optional dictation and web search use separate service keys. Web research can use a Tavily, Brave, Exa, Firecrawl, or Ollama key in Settings → Providers → Search. Ollama search uses its hosted service, not a local model server.

See Getting started for model setup, dictation, files, and notes imports, and context, caching, and costs for advanced cache preferences.

All three platforms support in-app updates.

Your keys, your data

Development and support

npm ci
npm run plugins:setup
npm run dev        # http://localhost:3000
npm test           # fixtures and fake providers

See the documentation index for all guides, development for setup and checks, architecture for the runtime, keyboard shortcuts, themes for the theme file format, and desktop builds and releases.

For trusted local plugins, start with the authoring guide and capability map. It links the question, practice-problem, submission, view-context and UI contracts. Use examples/plugins/ for small runnable templates, plugins/ for feature source projects, and the host architecture for internals.

Questions, bug reports, and feature requests: GitHub Issues.

Security vulnerabilities: report privately as described in SECURITY.md, not in public issues.

License

AGPL-3.0

The app is free and open forever. If we ever charge for anything, it will be for convenience — managed keys, hosting — never for features you can run locally.

learnharness (amosblomqvist/learnharness)

正在搜索数据库…

这是什么?LearnHarness 是一款桌面应用,它使用 AI 智能体帮你学习难懂的主题:先弄清你已经理解了什么,再规划通往目标的路径,然后每次讲解一个推理步骤,最后用练习题来考你。一个持久化的知识图谱会把你学过的内容保存下来,跨会话延续。
这只是另一个 AI 聊天机器人吗?不是。它遵循一个结构化的四步循环:测量(找出你的理解到哪里为止)、规划(构建通往目标的依赖关系图)、讲解(分步解释,并包含预测和检查)、练习(相互独立的会话,题目多样)。它还允许你大声说出自己的推理过程(打字或语音听写都可以),而不只是给对错打分。
我该如何让它运行起来?从 learnharness.ai 或 GitHub Releases 下载已签名的 macOS DMG、Windows 安装程序,或 Linux 的 AppImage/.deb,然后添加你的模型服务商 API 密钥、选择模型,并开始一个你想理解的会话。
我需要特定服务商的 API 密钥吗?你需要自带密钥,可以从 30 多家受支持的服务商中选择,包括 OpenAI、Anthropic、Google、DeepSeek 和 OpenRouter。可选的语音听写和网络搜索功能需要单独的服务密钥。
Windows 安装程序现在可以直接使用吗?可以使用,但目前没有签名,所以运行时 Windows 可能会提示“未知发布者”或 SmartScreen 警告。
我的学习数据和 API 密钥会去哪里?你的聊天记录、知识图谱、设置和 API 密钥都以本地、可直接查看的明文文件形式保存在你的电脑上,没有 LearnHarness 订阅费,也不加价。模型请求、联网检索和语音听写仍会连接到你配置的外部服务商。
知识图谱实际存储的是什么?它存储命题和推理链,也就是单独的论断以及它们所依据的前提,并链接回产生它们的会话,这样之后的讲解和练习会话就能在已有学习的基础上继续,而不必从零开始。
我能直接说话而不是打字吗?可以。除了打字之外,还支持语音听写作为可选的输入方式,需要单独的服务密钥。
除了文字讲解,它还能做别的吗?智能体可以在后台研究问题,并在讲解一个概念时生成可视化解释和交互式演示。
大小
12.8 MB
星标
9.9K
时长
1个月
提交 · 90 天